| 


“te 


CHES HFKESECKCeTetessteeHseos. 


CC 


eee seseesace: 


" EY-0072E-SG-0101 


RSX- 1 1M/M-PLUS 
Utilities and 


Commands 
A Self-Paced Course 


Volume | 


djijgjijtjall 


EY-0072E-SG-0101 


RSX- 11M/M-PLUS 
Utilities and 
Commands 

A Self-Paced Course 


Student Workbook 
Volume | 


Prepared by Educational Services 


Digital Equipment Corporation 


Copyright © 1982, Digital Equipment Corporation. 
All Rights Reserved. 


The reproduction of this material, in part or whole, is 
strictly prohibited. For copy information, contact the 
Educational Services Department, Digital Equipment 
Corporation, Bedford, Massachusetts 01730. 


Printed in U.S.A. 


The information in this document is subject to change 
without notice and should not be construed as a com- 
mitment by Digital Equipment Corporation. Digital 
Equipment Corporation assumes no responsibility for 
any errors that may appear in this document. 


The software described in this document is furnished 
under a license and may not be used or copied except 
in accordance with the terms of such license. 


Digital Equipment Corporation assumes no responsibility 
for the use or reliability of its software on equipment 
that is not supplied by Digital. 


The following are trademarks of Digital Equipment Corporation, 
Maynard, Massachusetts: 


DIGITAL DECsystem-10 MASSBUS 
DEC DECSYSTEM-20 OMNIBUS 
PDP DIBOL OS/8 
DECUS EDUSYSTEM RSTS 
UNIBUS VAX RSX 

VMS IAS 


10/82-15 


SG STUDENT GUIDE 


ENTRODUCT ION a: <6, cence: “6 - ee 8 ee Ge 
COURSE DESCRIPTION. . ...... 
PREREQULSLITES 0: vac cel “Si & wt: we ar- we 
COURSE GOALS. . . « « «© « «© « « e 
NONGOAES & oe 08: ce Se SS Se SS ae ee 
COURSE RESOURCES. .« »« « « © « « « 
COURSE ORGANIZATION .....e.. 
COURSE MAP... . a er a 
HOW TO TAKE THIS COURSE e 6 © 
PERSONAL PROGRESS PLOTTER % oe. Sew 
RSX-11M-PLUS CURRICULUM ..... 
COURSE “STRING: % soc w (ee (SO ew 


1 RSX-11M/M-PLUS SYSTEM OVERVIEW 


INTRODUCTION &:. 6.4: ce. % ow Ww 
OBd BCTIVESs. -é).45 es 42 46-4 4 ae Te ew 
RESOURCES 2. °4-- Ses Ses ee OR ee: one 
OVERVIEW. .. . Kes RY a BO we? U8 

The Hardware. Sh Mee. Ye A. ee A we 

The Softwares <<: s «© «© «© ‘s.« 3 
THE OPERATING SYSTEM. ...... 


LEARNING ACTIVITY .~ . 2. «© « «© «© 


THE RSX-11M-PLUS OPERATING SYSTEM 


RSX-l1IM/M-PLUS Characteristics. 


RSX-11M/M-PLUS Components .. 
Documentation . . 2. «6 «© « « « 
Other ResSourceS . .... « e« 
THE OPERATING SYSTEM. .....e- 
Memory USe. . 2. « © © « «© « « 
Tasks ... : ee Bs as 8 
Steps Required eo Run a Task. 


The System Task Directory (STD) 


Active Task List (ATL)... . 
Allocating Memory to a Task . 
ParGlUlLons. -».-~a is. «ew o % 
Checkpointing « « < «© « « * * 
Shuffling ... P ur ane 
Allocating CPU Time to a Task 
Round Robin Scheduling. ... 
Task Addresses. . 2. « « « « « 
Physical Addresses. ..... 


iii 


CONTENTS 


i ee Se 
a a oe ee 
co oe ew wo oe 4 
a ee a 
oe we ew ew 4 
a oe ee 
ee. 4 we 86 
a ee eee 
ee ae ae ae Sot US 
ae a a oe 
e.4, w e Ye? ed 
ofa Ber ve wt 


Mapped Systems. . . . .« « « « « « e« 
Unmapped Systems. . . 2. « « e« « «© e« 


2 GETTING STARTED ON THE SYSTEM 


TINTRODUCTION<e- Ss > Oe Sh tes er a we 
OBIBCTIVESs- « 3a wo a> Bes OO ve eo Se ee Sea 
RESOURCES .... . i et Se a ae Ge ge oe 
LOGGING ON THE SYSTEM eet et ee a OGY er ee 
User Identification Code (UIC)... 
PASSWOLGS: wet eo ee os San Get es 0 et 8, 
Command Line Interpreter (CLI)... 
Notes on Example 2-1. . . .« « « « « 
Notes on Example 2-2. . « « « « « e 
LOGGING OFF THE SYSTEM. . .. . «6 © « e« 
USING THE TERMINAL EFFECTIVELY. .... 
PERM AMAL S: oo. Se wk Se Se Mee ee Se See ee eo Te Ve 


LEARNING ACTIVITIES: ©. 2: @ a So @. & fo 4 


CONVERSING WITH THE OPERATING SYSTEM. . 
Command Line Interpreter (CLI)... 
CLI PYOMDPES: i. 2o- ia: We “fer coe ws ee et Se 2s 
Default CLI... &: °%. Jer G>4x ce, Ze 
Changing from One CLI to Another. . 
USING THE DIGITAL COMMAND LANGUAGE (DCL) 
Features Of DCE.:c-.s): Se 3 As eo vee 
DCL Command Format. . . 2. 6 « «© e« « 
THE HELP COMMAND. « « « « »© © © s « « « 
HELP Command Format ..... «+ e« e« 
Notes on Example 2-5. . . . « « « « 


LEARNING ACTIVITIES . 2. « «© « © © © @ »« 


PILE -SPECIPICATLONS. 6 «6. ee ce ce. lek “Mer 


Files e e e s e e e e e e e es e 
File Specification Command Format . 
Devices e e e e e e e e e e e 


Logical Device Names. . 
Notes on Figure 2-3... . 
Pseudo Device NameS . ....e. 
User File Directories (UFDsS). ... 
Pile: Namesac ao, Alay wh ar wee: He ve 
Pile TYPOS so «. 6 6. Se ae as 
VErSlIOnS. «< << «4 a . 
Wildcards in the File Specification 
WildCatdS: %: ws. 6. bo 8 we Oe ee eS 
Notes on Example 2-6. . ....e«.. 


Physical Device Names .. . 


iv 


56 
57 


61 
61 
61 
63 
64 
64 
65 
65 
68 
70 
72 
72 


76 


77 
77 
77 
78 
78 
78 
79 
8O 
88 
88 
89 


93 


94 
94 
95 
96 
96 
198 
109 
183 
185 
185 


185 


195 
119 
110 
lil 


LEARNING ACTIVITY . 


USING THE MONITOR CONSOLE ROUTINE 


MCR e e e e e e 


PRIVILEGED COMMANDS 


INTERPRETING ERROR MESSAGES ... 
Error Message Format. . 


MCR Command Format. . 
Notes on Example 2-7. 


3 CREATING AND MODIFYING FILES 


INTRODUCTION. ... 
OBJECTIVES. . 2... 
RESOURCES: «6 s.& @ 
OVERVIEW. . « « « -« 


Purpose of an Editor. ... . 
EDT Editor Features ..... 
CREATING A TEXT FILE. 
Notes on Example 3-l. ... . 
EDITING AN EXISTING FILE. .... 
Notes on Example 3-2. ... . 


THE HELP FACILITY . 
Command Format. 


EDITING COMMANDS USING LINE MODE. 


COMMAND MODE COMMANDS 
Displaying Lines. 


Command Format. 
Inserting Lines 
Command Format. 


LEARNING ACTIVITIES 


Deleting Lines. 
Command Format. 
Copying Lines . 
Command Format. 
Moving Lines. . 
Command Format. 


Text Substitution 


Command Format. 


Renumbering Lines 


Command Format. 


Ending the Edit Session... 


Command Format. 


LEARNING ACTIVITIES 


Character Mode Features ... 


116 


117 
Lad. 
LTS 
120 
127 
128 
128 


133 
133 
133 
135 
L355 
138 
139 
139 
148 
14 
141 
141 
143 
144 
144 
144 
147 
147 


149 


150 
15 
152 
142 
153 
153 
156 
156 
158 
158 
16 
160 


166 


161 


THE KEYPADS <6. -x> o> Go o ~m -<b 9 -et cet ee Sa a a ee ee 162 
VT19® Keypad Functions. . . . 2. «© «© © © © «© « «© «© 162 
VT52 Keypad Functions . .... « « «© «© «© «© «© «© «= 163 
Changing to Character Mode. . . . « « « « « « « « 164 
Positioning the CurSor. . . «2. « « « «© © e «© © © e« 165 
Positioning the Cursor (Alternate Methods). ... 168 
INSGreing "Texts: 6 wow ww. We! ay Sr i ee ee et ee eT 
Deleting TExXt: 4. ss alse. We ew LS we we ee wwe «CTS 
Help Function . « « © « @© © «© © © © «© © «© » « «© « J74 
Exiting Character Mode. . . . .« « « « « © « «© « « 174 


LEARNING ACTIVITIES . « « « «© © © © © © © © © © © «© © «LFS 


4 FILE AND DIRECTORY MAINTENANCE 


ENTRODUGCT ION ws ee iw 36 en es We i Se a te 179 
OBGEBCTIVE Oe ove. 6. se! tee Re ee ce CA aa A eae Sa - S). 179 
RESOURCES. a: cer ao Gl <k> a? se ee ae ee a Ste a ee ee 179 
BPIGEE -STRUCTUR Bie oe: odo ces ce Sa ce ke OR ese ee Rt ee i Be Le 181 
PIL BS= 1 Me. S-x6> ta cde ee SE el. ae ce, es Sek Fee Se ee es, Se ee BT 
Master File Directory (MFD) .......-.+.-.. 181 
User File Directory (UFD) . . .... «+. « «© « « %181 
User Default UPD. 6 Bek ce ee a oe me es wes wr: LA 
User Default DGévice sy. 2 8-4-5 4. 4:8 1S hk SE 2 we a we: 1S 
System UPDS! 4. «3: 6 @ Ss. ee Sie ow ee ee te ae Se eB 


LEARNING. “ACTIVITY: <a: \ei ter —ies veh a dee OY Se: eS ee Se wl See Ge ee 


MAINTAINING A USER FILE DIRECTORY .... 6 « «© « «© « 188 
Command Formats: >a. 08-8 wias ee eS ae ce 4 co «BB 
Defaults in File Specification. ......... 4199 
Command FOtmats:-s- e768 <a ws 4 at eS we eS Se eS A oe TOP 
Listing: DEFECEOTLES:..y. 6: he a ce we eS ee he tS ee «TO 
Command: Formate: so 6-04. co ee. By 6: es We ene ee ce es ce «DD 
Notes on Example 4-3. . 2. « « «© « © © « «© © © «© « 196 
Debeting Piles... 60 6 eer a. Me Ss oS we Se el Se Ee a we TOT 
Command “Format. 6. el ee 5 Ue Ge Ma a ae es ew Ce EDT 
Purging Old: Pites: «ssc e: Yo wer es “Soe a a a ee ES 
Command -POrMaty aos wo a ale, eee Gr WW. cS Me wee. “199 
Notes: "on -Bxampie 2-505 ee ae SS ee elo es eee ee “ees ee DT 
CODYANG- FE LLCSs io eo e: Gol a ag ee Se ee, ee ew, te eS 
Command, -FOrMats. <4 e: Ye a ses Sr Kb le es es As Se Be eR DBD 
Renaming Files. . . . « «© «© © © «© «© © © © © © © © = 283 
Command: (POEM Es -a: ise <6 6? 20. eel We: OS el es ee ws Ge, 22D 

INSPECTING THE CONTENTS OF FILES. ...... + © «© e 205 
Displaying File Contents at Your Terminal . ... 205 
Command: Formats (6) ve <6 Bis eee we 0, Se Se el es Ss te 205 


vi 


Displaying Files on a Line Printer. 


Command Format... 


PRINT Command Hetaules. 


LEARNING ACTIVITIES . . 


PROTECTING YOUR FILES , 
File Ownership... 
File Access Rights. 


Default File Protection 
Setting and Changing File 


Command Format. .. 


Equivalent MCR Commands 


LEARNING ACTIVITIES . . 


5 PROGRAM DEVELOPMENT 


INTRODUCTION. . . .. . 
OBJECTIVES. 2. 2. 6 2 « « 
RESOURCES . . 2. . «© «© e 
OVERVIEW. .. . ° 
PROGRAMMING LANGUAGES ° 


LEARNING ACTIVITIES .. 


ASSEMBLING/COMPILING. . 
MACRO-11 Language . 


Protecti 


MACRO-11 Assembler Command Sormat 


Common Error Messages 


Notes on Example 5-1. 


LEARNING ACTIVITIES .. 


FORTRAN Languages . 


FORTRAN Compiler Command Format 
Common FORTRAN Error Messages 
FORTRAN Compiler Listing. 


LEARNING ACTIVITIES .. 


TASK-BUILDING/LINKING . 
Overview. . 2. 2. « 
Notes on Figure 5-4 


Task Builder Command Format 


Common Task Builder Error Messages. 
Interpreting a Task Map . 
Notes on Example 5-3. 


vii 


207 
287 
268 


288 


209 
269 
212 
213 
214 
214 
215 


216 


221 
221 
221 
223 
226 


229 


230 
232 
232 
235 
236 


238 


239 
239 
242 
242 


244 


245 
245 
249 
256 
253 
254 
255 


LEARNING ACTIVITIES e eo e e s e e e e e e e e e e e e 256 
RUNNING THE TASK. e e e e e e e e e e e e e e e ° oe e 257 
LEARNING ACTIVITIES e e e e e e e e e e e e ® e e e e 257 


Notes on Figure 5-5 e e e e e e e e e e e e e o e 258 


6 USING THE EDITOR EFFECTIVELY 


ENTRODUC TIONS, ~e~ ec -de. ee a See te a ee Pee Se es a Oe ee ae * 
OBJECTIVES 4: aS ta. c i Se Eee ie, oe A a ee oe a OL 
REDOURCE Oye: airy 2g ter vie’ <a, te tes we Se cies de. te we ee oh, te Ae, ee es SZ 
USING THE EDITOR EFFECTIVELY. « « «© «© » » =» «© © »@ © @ 263 
EGLvOr Bai Ler Si. <.. Ge et Su Sey Hewes Se ce ee a a Gwe, (203 
BUPEGr VSG e. od- seo i ee bey te cee ks et ae Ce ee ie ee ee SS 
Creating a: BULTEr i. a ce. ee ed me SS es HS te ewe “G. -268 
Referring to a Buffer . . 2. « «© «© © © © © © «© «© « 264 
LINE MODE: FEATURES 6. %- .e--e>- e. Jab oe <M es a oe. th 1 ee. 25 
Searching for a Character String. .......e. 265 
Reading: and Writing PLIES: «6. 6% aw. ew ee ee ia, 9265 
Generating EDT Macros . . .« «© « «© © «© «© © « «© e « 266 

Py ACEO 6. %n: Me! sep eis > “wer ee We tes “ee SC es de ee. 2G 
Defining: a (MACrO.. 2° wr we wo Bee a SS, ZOF 

Notes on Example 6-1. «3 <« 6 «© “Sw oS 6 6% 6 «© w @ 267 
Setting Editor Parameters . . 2. « « « «© «© «© © « e 269 
Additional Line Mode Commands . ......-..-. 279 

. The ‘Startup: Command Pile. . & <« « 6 <= 6 6 «© @ oe 277 
CHARACTER MODE  PEATURES, 4) -.--:. se <e ce, 6. <o, w es Gy os, es we OS 272 
Additional Keypad Functions . ......-.-.«.-. 272 


LEARNING ACTIVITIES e e e e e e e e e e e e ° e e e e 273 


Other Character Mode Functions. . ..... ++. 274 
String Searches in Character Mode ........ 275 
Cutting sand ‘Pasting Texte: sow. ac so ee lecs oe et te ee «|CODTS 
Repeating Functions Automatically ........ 276 
Entering Line Mode Commands . ....... «+ «+ «© 277 
Nokeypad Character Mode . . 2... «6 © © © © «© « « 278 

Invoking Nokeypad Mode. . . . «2... «++ « « 278 

Exiting Nokeypad Mode « . . « « « « « «© « « » 278 


LEARNING ACTIVITIES e e e e e e e e es e e e e e e e e 279 


7 USING INDIRECT COMMAND FILES 


INTRODUCTION. e e 2 ® e e e ® e e e s e e e e e e e e 283 
OBJECTIVES. e s e e e e e e e e e e e e e e e e e e e 283 


RESOURCES e e se e e e e e e e e e e e e 
WHAT IS AN INDIRECT COMMAND FILE. ee ee ee 
CREATING SIMPLE CLI COMMAND FILES .... 


CREATING SIMPLE TASK INDIRECT COMMAND FILES e. %6 


Benefits of Using an Indirect Command 
LEARNING ACTIVITIES . « «© « «© « © © «© « 


INCLUDING DIRECTIVES. . « « « «© © © e we « 
DIiTECCUIVES 6. 2: wr ve Wi i oe tor cS ae WL ww De 
SYMDOLS: «@: & es @ es «6 ~« ws Ue a, Se te 

Values Given to Symbols a ee ae ee 

Logical Test Directives ..... 

Logical Control Directives. ... 

More Useful Directives. ..... 

Special Symbols . .... =. « « « 


LEARNING: ACTIVITIES: <i: a -e2 el pat wt “Sn ee ee “e 


Establishing Symbols. . . . .. «.« « e« 
Notes on Example: 7J=ls. oo eed, 6s war 
Asking the User for Input ...... 
Notes on Example 7-2. . . .. .« « « « 
Notes on Example 7-3. . « « «© « «© « e 
Making Logical Tests. . ......-. 
Notes on Example 7-4. . . . ». « « « e 
Notes on Example 7-5. . 2... « « « e 
Controlling Execution Flow. .... . 
Setting Operating Modes . ...... 
Notes on Example 7-8. . ...... - 
Notes on Example 7-9. . . «2... « « « 
Using Special Symbols ........ 
Notes on Example 7-18 . . .. «2... . 
Notes on Example 7-1ll ......e... 


8 CONTROLLING TASK EXECUTION 


EN TRODUCTIION s. 65 se-35e ee net Sar, Soe pee ws ee St te 
OBJECTIVES. « « «© © © © © © © © © © © 8 
RESOURCES ... So ee Uae BS a ee Ss 
HOW RSX MANAGES TASKS ° o 6 © © © 
Priority and Scheduling Be ar ee ee 
Task StateS . . « « © « © «© © © «© « « 
Memory Allocation . . 2. « « « «© e « « 


LEARNING ACTIVITY e e e e e e e e e e e e 
USING TASK BUILDER FACILITIES ..... . 


Assigning a Task Name ......«.-e 
Setting Task Priority . ....-e..«-. 


ix 


File. 


283 
285 
285 
287 
289 


289 


298 
290 
291 
291 
293 
295 
296 
297 


297 


298 
298 
361 
381 
363 
386 
386 
389 
319 
312 
312 
314 
316 
316 
318 


325 
325 
325 
327 
327 
329 
33:1 


331 


33¢ 
332 
333 


Indicating a Partition. 
Making a Task Checkpointable. 


Assigning Logical Units 


Notes on Example 8-l. 


LEARNING ACTIVITIES 


INSTALLING A TASK 


e 


Notes on Example 8-2. 


RUNNING A TASK. 


Running Tasks Immediately 


Installed Tasks 
Tasks Scheduled 


LEARNING ACTIVITIES 


9 LIBRARIES 


INTRODUCTION. . 
OBJECTIVES... 
RESOURCES ... 
LIBRARIES ... 

Benefits of 


Notes on Figure 9-1 
LEARNING ACTIVITIES 


Macro Libraries 


Usin 


to Run Later. 


g 


Object Libraries. 


Using 
Notes 
Using 
Notes 
Using 


LEARNING ACTIVITIES 


Libraries 
Library File Format . 


Universal Libraries 


Macro Libraries 
on Figure 9-5 
Object Libraries. 
on Figure 9-6 
Universal Libraries 
Creating/Maintaining Libraries. 


Notes on Example 9-1. 
Notes on Example 9-2. 


10 ADVANCED MAINTENANCE OPERATIONS 


INTRODUCTION. . 
OBJECTIVES. .. 
RESOURCES ... 


VOLUME MAINTENANCE, 


e 


333 
334 
335 
337 


348 


341 
342 
343 
343 
343 
344 


445 


349 
349 
349 
351 


S51 
352 
353 


354 


355 
Soe 
359 
362 
363 
364 
365 
366 
366 


378 


373 
375 


379 
319 
379 
381 


Device Types... -« 4: & 46.4 ° 
FILES-11 Volume Structure ne ee ee ee 
Volume Files. ...... 
Index Files «0. 6 ¢ & = « 
Bitmap File... a oe, re 
ANSI Magnetic Tape Structure. eo 8 
Other Tape Formats. . . « « «© « « « 
Device and Volume Accessibility. . 
Device Ownership. . .« « « « « e« 
Mounting a Volume ....... 
Preparing a Disk Volume for Use. . 
Physical Formatting ..... .» 
FILES-11 Initialization... 


Preparing a Magnetic Tape Volume for Use. ° 


Backing Up a Volume .. 
Backup and Restore Utility (BRU) . 
Command Format. .. ° 


Disk Save and Compress Utility (DSC) . ° 


VERTPY: (VEY Jess 2. av eo ee So ee eS 
LEARNING ACTIVITIES . .~£ « « « «© © «© @ «@ 


PLGE. MAINTENANCE © -%. so: <..<e- i ee ek en ee 
Transferring Files Between Computer 
File Transfer Program .... . 
Transfer Mode Switches. ..... - 
Command Format. .- 6 6-6 «© 6 # 0 6s 
Controlling the Print Queue .... 
Looking at the Contents of a File . 
File Dump Utility (DMP) .... 

Command Format. . 2. .« « «© «© «© «© « e 


LEARNING ACTIVITIES . . 2. «© « «© «© « © « 


PROGRAM MAINTENANCE . 2. 2. 6 © «© © «© © «@ 
Comparing the Contents of Two Files 
File Compare Utility (CMP)... 

Command Format. . .« « « © »© © « «© e 


LEARNING ACTIVITIES . . 2. «© 2 se © © @ 
AP APPENDIX 


BATCH JOB FILE. . « « «© «© «© © © © © @ » 
BATCH Command Line. . 2... « «© « » « 
Command Format. .. a ee ee eee 

PROCESSING THE BATCH FILE ee ee ee ee 
Command Format. . .. «+6 © « © e « e 


Systems 


381 
382 
383 
384 
387 
389 
389 
391 
391 
392 
393 
393 
393 
394 
396 
396 
397 
399 
399 


499 


491 
AGl 
461 
463 
493 
495 
469 
469 
419 


414 


415 
415 
415 
Al5 


418 


419 
420 


420 
422 


422 


RPrRWOONADU BP WN FP 


& 


= 


Pee eee Peep pe 
a 
WN 


NNNNN DN 
i tf t bol 
DU PSWNH EH 


FWO OTN U HBWNHY FE 


Q 


WWWW WW WWW WwW 


Ph hb 
toto 
MON 


The Documentation. . . .« ©. « « « « -» 
Sequence for Reading Manuals .... 
Memory Use e e e e e e e e e e e e e 


e e e e 


A Task is the Result of Program Development. 


System Task Directory. ~~. « « « « « 
Active: ‘Task (LIS€ «© -o: 2 <é Jes 60S ee a 
Tasks are Built with a Priority... 
Memory Divided Into Partitions ... 


e e e e 


Tasks Execute in a Specific Partition. ... 


Running Tasks in a System-—-Controlled Partition 
Running Tasks in a User-Controlled Partition . 


Checkpointing a Task . ....e.-. 
Partition Fragmentation. . .... -« 


FIGURES 


Partition Shuffling to Obtain Contiguous Memory. 


Task States s. ws a> as eT ee ee a 
Round Robin Scheduling ...... - 
Virtual Address Space. . ....e. - 
Physical Address Space... ° 


Mapping a Virtual Address Into a Physical Address 


on a Mapped System ....e. a. ee 2s 
Task Built to Execute on an Unmapped 


LA12@ and VT19@ Keys . .... +... 
Physical Device Names. ....... 
Logical Device Assignments ..... 
Pseudo Device Names. . ....... 
Standard File Types Depicted . : 

Valid File Specifications for Latest 


Creating a Text File . . 2. 6. « « « « 
Modifying Existing Text Files. ... 
VT19@ Keypad Functions .....e-. 
VT52 Keypad Functions. . .....e. 
Changing to Character Mode ..... 
Positioning the Cursor .... . ° 


System. 


A.FTN Version 


Positioning the Cursor (Alternate “ethode) ‘ 


Inserting: Text: 4 4. so. oh. was 4 MS er Bs eles 
Deleting Text. . .. - ° a ee 
VT1@8 Keypad Editing Help Text =: Yer 


FILES-11 Directory Structure... . 
User File Directories. .....e. 
Changing the Default UFD and Device. 
Transferring File Ownership. .... 


xii 


e e e e 


26 
29 
31 
33 
35 
36 
37 
39 
40 
42 
43 
45 
47 
48 
58 
53 
54 
25 


56 
S7 


74 
97 
101 
184 
186 
189 


136 
137 
162 
163 
164 
165 
168 
172 
173 
174 


182 
183 


185 
218 


NON dO 
WNHF 


Accessing a File ..... 


The Program Development Process. 


Translating a Program Source File Into 


Machine Language .... 


Task-Building an Executable Image. 


Task Image Structure... 
Requesting a Task to Run . 


Creating and Invoking a CLI Indirect Command 


A MCR Task Indirect Command File 


Highest Priority Ready-to-Run Task 


COMULOLs «: a «> a Bice tec 
Task StateS. . 2. . « © « »« 


Library File Format. ... 
A Macro Library. .... -» 
Object Libraries ..... 
Universal Libraries. ... 
Using Macro Libraries... 
Using Object Libraries. . 


FILES-11 Standard System Files 


Volume .... So. tas ae ae Se 
The Two Parts SE a File. . 
Index File Format. ... 


Gains CPU 


Directory Structure for Single- -User Volume ‘ 
Directory STructure for Multiuser Volume. . 


ANSI Magnetic Tape Structure 


PDP-11 File Structures. . 
The Queue Manager. .... 


How the DMP Program Interprets 16 Bits o 6 « 


PDP-11 Operating Systems . 


Characteristics of System- and User-Controlled 


PartGltions: «ai oe & Sas 


e e e e e 


Significant Events that Cause Rescheduling 


of the CPU e e e e e e e e 


Special Terminal Keys. a 


Echoing of Delete Key on CRTS/Hardcopy te 8 


Partial List of DCL Commands 


xiii 


216 
225 


231 
247 
248 
258 


286 
288 


328 
330 


352 
356 
358 
368 
362 
364 


383 
385 
386 
388 
388 
398 
4G2 
486 
411 


19 
41 
51 
75 


76 
81 


NNMNMNMNNN NY 

Piettt @ st 
PROMO D US 
eS 


WW 
{ 
NF 


PE HP HH Lh & 
1'uoeted 
SNOB WN 


1 on OF U1 OF OF U1 O01 U1 
WOAN KAU PWN EH 


DH OV 
1ot it 1 ot 
“IOV O01 B W Ne 


;idtdiot 
SNOB WH PE 


sJ~ 4 SI SI SI NS DAHAN OV 


RSX-11M/M-PLUS Peripheral Devices. . .....e- 
Pseudo Device Names. . 2. « « « © © © © «© «© «© we ew 
Standard File Types. . . .« « « « «© «© © © © © « «© « 
File Specification Defaults. . . . 2. « « «© «© © « e« 
Allowed Use of Wildcard Characters ....... - 
Partial List of MCR Commands . ....e.e« « « e « » 
Partial List of Privileged Commands. ....... 
Some Common Error MessageS . .« « « « « © «© «© © « « 


Line’ Mode ‘Commands « «<6. 6. #66. 6 we we we ee 
Range Specifications . . « « « « «© © « «© © « « « « 


Special User File Directories. . .... «+... -. 
File Maintenance Commands. . . . 6 « « « «© © © « « 
Defaults in a File Specification .......e... 
Groups of UserS. . « «© « «© «© © «© © «© © © © © © «© » 
ACCESS RIGHtES «6. 2. 6. eS ser He GS Sw a Se 
Default File Protection. .« . 2. « « « «© « «© «© @ « «@ 
Equivalent MCR File Maintenance Commands ..... 


Language TypeS . .« «© « « « © «© « © © © © «© «© © «© « 
Available Lanaguage Translators for RSX Use... . 
MACRO Command and File Qualifiers. . ....e.. 
Examples Using the MACRO Command . .....e.. - 
FORTRAN Command Qualifiers . . ..... «© « « « e 
Examples Using the FORTRAN Command ....... -« 
LINK Command and File Qualifiers . .......-. 
Examples Using the Task Builder. . ......e.. 
Standard Task Builder Defaults . ......e.e. 


String Search Commands in Line Mode. ...... . 
Line Mode Commands to Read and Write 

Files from. Within BDT< << < wa 6. a) a oo «se So es 
SET and SHOW Commands. . . «© « « « © © «© © © © «© « 
Other Useful Line Mode Commands. ...... « « « 
Additional Commands to Move the Cursor ..... - 
Additional Character Mode Function Keys. ..... 
Nokeypad Character Mode Commands ....... «6 e« 


Directives to Define Symbol Values ........ 
Directives Used to Perform TestS . 2... .. « « « 
Relational Operators . . . « « © © © © «© © © «© © » 
Compound Logical Operators . . 2. .«. « « « © « «© « « 
Directives Used to Control Command File Execution. 
OEhEr DITECEIVEeS «60 c-Si ete. eh ee lw ee 
Special Symbols to Obtain System and User 

THEOTMACLONG... vo: ie 2 ok ee a ep ee Ls GR es 


Xiv 


163 
107 
188 
116 
119 


127 
129 


143 
145 


187 
189 


191 
212 
212 
213 
217 


227 
228 
233 
234 
2408 
241 
251 


252 
253 


265 


266 
269 


270 
272 
274 
278 


292 
293 
294 
294 
295 
296 


297] 


NON MN N ND NY 
SDOB WD 


WWWW WW W 
SHO PB WD 


Overriding Task Attributes ... ra ae ee 
MCR Commands to Invoke the Task Builder 
to Override Task Builder Defaults. ..... 


Sources of EPT, MNT Entries Used in Creating 
a Library File ...... ee ee oy < + 6 
DIGITAL-Supplied Libraries on LB:[l, 1] a. ta Se 
DCL Library Commands . ......-.«-. « « » 
Equivalent MCR Library Commands. ...... 
CREATE Command Parameters and Qualifiers. . 
Librarian Listing Qualifiers ........ 


Device Ownership . . « « « « «© « © © © «© # « 
Volume Accessibility .......-...e-. 
Backup Command Qualifiers. . ......«e« 
FLA Pormat Switches... 26. «a> ee ce. wi er a ae 8 
Default Transfer Modes .....-. +. «© © « « 
Print Command Qualifiers . ...... « « e« 
DCL Commands to Alter Print Queue. ..... 
Equivalent MCR Commands to Alter Print Queue 
DMP. SWItCH. FOrmMats. s.é. a) 4° .a: Ge Niel “oh te BY 


Batch... COMMANGS: 6-5 we Gel So RO we Se va Se Sh 
Exit “Status: Code: 2: 65 Gs 28. es Gee; Be, ech Se ee ee 
Submit Command Qualifiers. . ......e « « 
Changing the Batch Queue ...... +. « « 


Logging On the System. . . 2. 2. «© «© © «© «© © « 
Sample Terminal Session. . ...-.. « «© « « 
Logging Off the System .... . « « «© « «© » 
DCL. “Commands: «. 6 2° @ eGo Boe 6 WO OS ee 
HELP -COmmManG: <6 6.“ ec ce: at Se “ee eee Re Se 
Using Wildcards in a File Specification. .. 
MCR Command Samples. . ...... «+ «© © « e« 


Creating <a Text: Pile ss <<. 2) se: oe ee ee eS 
Editing an Existing File . ......e« « « 
HELP Command « «6. « « «© «© @ s « * % 
TYPE ‘COMMANG.<¢. 2 @ @ % @o8 Bees 

INSERT -COMMANG® «3 49. és 3 > me, RE 
DELETE Command << «© «2. ws % 

COPY “Command. 2: <4: 6: @-“e)- 40 Be OR Sa ee Os 


XV 


338 


339 


354 
361 
367 
368 
369 
369 


391 
392 
398 
494 
494 
497 
498 
498 
411 


421 
423 
423 
424 


EXAMPLES 


67 
69 
71 
82 
98 
112 
121 


139 
149 
142 
146 
148 
ep 
152 


W WW 
I 

ke \O © 

Q 


PHP HEHEHE DH LH 
I 
RPrRODMDATNANU BWND EF 

re & 


ul Oo U1 
{ 
WN 


a 
I 
_ 


~JI~~ ~~) 
( 
1 & WN FF 


SJ] SW SN SIN 
I 
erro OTN 


MOVE. Command.« o-< ~ a6 © “-SW-ce Sy eS 
SUBSTITUTE Command ...+..e © e © e « 
RESEQUENCE Command . . . « «© © © «© « « 


How the Default UFD Works. .....e 


Using Defaults in a File Specification 


DIRECTORY Command Samples. . .... - 
DELETE Command Samples . ...... 
Purging Files. . « « «© «© © © = » © # « 
COPY: COMmmana sc <a> ei cee ee Wl ar RE ee? ws 
Renaming Files . 2. . « « « « © «© «© « e« 
Using the TYPE Command .......e ~~. 
Pude OWnersnip se wi owe se Ee ere oR EOS 
Transferring File Ownership Samples. . 
Setting File Protection. ~« «© «@ <- @.« « 


Sample MACRO Assembly Listing. .... 
Sample FORTRAN Compiler Listing. ... 
Sample Task Maps -« <% “Go # ow 3 6 @ oes 


Defining a Macro . . « « « © © © © « » 


-SET Directive - Used to Define Symbol 
-ASK Directive - Used to Define Symbol 


Value 
Value 


Execution of INPUT.CMD Showing User Response 
Using the .IF Directive to Test Symbols. . . 
Execution of LOGICAL.CMD and the Results of User 


Input. e e e e e e e e e e e e e e e e 


Command File Showing How to Control Execution Flow 
Execution of CONTROL.CMD and User Response . 
Command File Showing Operating Mode Usage. . 
Execution of OPERATING.CMD and User Response 
Command File Showing Special Symbol Usage. . 


Execution of SPECIAL.CMD ....... 


An Indirect Command File to Send Message 


to Terminal, and Change Current CLI. . 


An Indirect Command File to Edit, Print 


and Purge Files. . . « « « « © » e « e 


e 


e 


e 


Associating Logical Units with Physical Devices. 


Samples of Installing a Task ..... 


Obtaining Library Directories. ... 


Commands to Create a Library and Delete Modules 


EPROM: that. LIDPaPY 6: me: a: er Aes 4 Rh es. we 4-8 
Preparing a Disk Volume. ...... .- 


Preparing a Magnetic Tape Volume... 
Directory File Header Dump ...... 


Xvi 


154 
157 


159 


186 
191 
193 
198 
208 
262 
263 
206 
209 
211 
214 


237 
243 
254 


268 


388 
362 
395 
308 


369 


310 
311 


53 
315 
317 
319 


328 


321 


337 
341 


371 
374 
395 


395 
412 


Directory File Dumped in Octal Word Mode 
Directory File Dumped in Radix-5@ Mode 


Two Similar ASCII Files... 


Compare Program Output Between Two ASCII Files 


Change Bar Format. ..... 


Batch Control File to Print MACRO Source Files 


Sample Batch Command Files . 


Xvii 


® 


e 


413 
414 
416 
417 
417 


425 
426 


STUDENT GUIDE 


STUDENT GUIDE 


INTRODUCTION 


RSX-11M/M-PLUS Utilities and Commands instructs you in the 
facilities of the RSX-11M operating system, one of many operating 
systems run on a PDP-1l. Each module discusses a primary feature 
of RSX-11M that should be mastered, as well as the objectives, 
resources, and laboratory exercises needed to learn the material. 


COURSE DESCRIPTION 


This self-paced version of RSX-11M/M-PLUS Utilities and 
Commands is the first operating system specific course in the 
RSX-11M/M-PLUS course string. It is the base for all higher level 
RSX courses. It instructs system managers, operators, programmers 
and other users how to interact with the operating system _ to 
perform basic daily work functions. 


Major course topics covered: 


e How to log on and off the system and issue commands that 
provide system information. 


e Use interactive editors and file maintenance utilities to 
create and maintain file collections. 


e Use of compilers/assemblers and other utilities to develop 
MACRO-11 and FORTRAN programs. 


e Use of indirect command files to control interactive job 
execution. 


e Use of file and volume maintenance utilities to prepare 
new volumes, and to back up user files. 
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PREREQUISITES 


l. 


Knowledge of the concepts of minicomputer organizations as 
in the DIGITAL course, Introduction to Minicomputers, 
audio/visual or lecture/lab format. 


Knowledge of PDP-1l organization and programming as in the 
DIGITAL course, PDP-1l Concepts for High-Level Language 
Programmers. 


COURSE GOALS 


1. Knowledge of RSX-11M/M-PLUS terminology and operating 
philosophy. 

2. Ability to find information in the system documentation. 

3. Use a terminal to communicate with the system. 

4. Create and maintain files. 

5. Assemble, compile and task-build supplied programs. 

6. Maintain a file directory. 

7. Control the execution of supplied programs. 

8. Create, maintain and use libraries. 

9. Perform tasks needed to use private disk and tape volumes. 

NONGOALS 

l. This course does not teach the MCR command language. Some 
MCR commands are referenced in a particular table. If you 
wish to learn MCR, do so in the lab. 

2. You will not learn the syntax rules of FORTRAN and MACRO, 


or how to write a FORTRAN or MACRO program. It is assumed 


that you are familiar with the syntax structure of either 
FORTRAN or MACRO-1l1. 
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COURSE RESOURCES 


The following are available resources: 


Ls 


6. 


This Student Workbook. 


Operating system information files provided by the HELP 
command. 


RSX-11M/M-PLUS Documentation Set manuals. 


On-line example files and indirect command files supplied 
by your instructor. 


Your fellow students -- Sharing ideas and questions is 
rewarding. 


Your instructor. 


The following documentation is essential to the course: 


1. 


Introduction to RSX-11M and RSX-11M-PLUS 


RSX-11M/M-PLUS Command Language Manual 


MCR Operations Manual 


Utilities Manual 


Task Builder Manual 


EDT Editor Reference Card 
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COURSE ORGANIZATION 


This is a self-paced course with laboratory sessions’ and 
written exercises. In place of a teacher you have a course 
administrator and a subject matter expert. In Some cases, the 
same person may perform both functions. The course administrator 
manages the mechanics of this course. He makes sure you have easy 
access to the system and the on-line course materials. As you 
finish modules, he records your. progress. The subject matter 
expert will answer any technical questions. Before you consult 
the expert, however, read the course materials and references’ in 
an effort to answer the question yourself. 


The Student Workbook is divided into modules which consist 
of: 


e An introduction, which describes the purpose(s) of the 
module and motivation for meeting its objectives. 


@e One or more objectives, which describe operations you 


should be able to perform when you have completed the 
module. 


e A list of resSourceS you may require to complete the 
module. 


e The module text, which includes the following elements: 
- Descriptive text. 


- Illustrations, which clarify the relationships among 
various elements of a RSX-11M/M-PLUS system, or 
Summarize steps of a particular process. 


- Tables, which summarize the operations covered by the 
module, and list the commands you enter to perform 
those operations. 


- Examples, containing sample listings’ from actual 
terminal sessions. 


e Laboratory exercises, available in a separate book, which 
provide the practice needed to master the module 
objectives. Solutions to the exercises are also provided. 


COURSE MAP 
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The course map shows how each module of the course is related 


to the 


other modules and to the course as a whole. 


Prerequisite 


modules are those whose arrows in the map point into a module and 
should be accomplished before proceeding to the next module. 


USING 
INDIRECT 
COMMAND FILES 


USING THE 
EDITOR EFFECTIVELY, 


LIBRARIES 


CONTROLLING 
TASK EXECUTION 


PROGRAM 
DEVELOPMENT 


ADVANCED 
FILE & VOLUME 
MAINTENANCE 


FILE & DIRECTORY 
MAINTENANCE 


CREATING & 
MODIFYING FILES 


GETTING 
STARTED 


TK-7872 
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HOW TO TAKE THIS COURSE 


Because this is a self-paced course, you determine how much 
time to devote to each subject. You can quickly cover familiar 
topics. You can spend more time on topics which are of more 
interest or use to you in your job, and less time on topics of 
little use. 


Whenever you are ready for a new module, read the 
introduction and the objectives. If you feel you already 
understand the material in the module, you can go immediately to 
the Tests and Exercises for that module. If you do not understand 
much of the material, read the module. The text explains new 
concepts and refers you to related readings in the supplementary 
manuals. The listings provide typical examples of the operations 
that a user performs. 


Some of the readings in the manuals are essential and others 
are optional. If you feel that you need no further clarification 
on a topic, skip the reading. However, if it is a topic you wish 
to pursue, an appropriate reading reference is provided. 


As you study the module, keep the module objectives in mind. 
If a skill is listed as an objective, be sure to master it. Later 
modules may depend on this skill. 


While you are reading through the module, try the commands 
being discussed on your own terminal. This interactive way of 
learning will help your understanding of the command. Practice 
the commands repeatedly until you fully understand their function. 


The files needed for this course are located in UFD [28@1,1] 
on your system disk. If they are not there, check with your 
course administrator to find out where they are located. Do not 
modify the files in UFD [2@1,1]. Instead, copy the files to your 
own UFD and use them there. In this way, the original files 
remain intact for the next student. 


Once you have read the modules and done the learning 
activities, you can do the lab exercises. The solutions are 
included in the Test and Exercises book. 


Once you have mastered the objectives of a module, the course 
administrator will record your progress on the progress plotter 
below. Then, you are ready to begin a new module. Otherwise, 
return to the module text for further study. 


The time that you spend on this’ self-paced course is 
dependent upon your experience and interest in the topic as well 
as time spent experimenting with the system. Use Table 1 as a 
guide when you set your schedule. 
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PERSONAL PROGRESS PLOTTER 


Date Date Time Sign-Off 
Started Completed Spent Initial 


1. RSX-11M/M-PLUS 
System Overview 


2. Getting Started 
on the System 

3. Creating and 
Modifying Files 

4. File and Directory 
Maintenance 

6. Using the Editor 
Effectively 


7. Using Indirect 
Command Files 
8. Controlling Task 
Execution 
18. Advanced Maintenance 
Operations 
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Table 1 Typical Course Schedule 
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RSX-11M-PLUS CURRICULUM 


The RSX-11M/M-PLUS curriculum is illustrated in the Course 
String below. 


After completing this course, depending upon your final 
objective, you Should take the System Management course, and 
either Programming in FORTRAN IV or Programming in MACRO-1l. One 
or the other iS a prerequisite for Programming RSX-11M in 
FORTRAN/MACRO, which is available in both lecture/lab and 
self-paced formats. To derive the most benefit from a higher 
level language course, the prerequisite courses must be taken. 


dl 


RSX-11M 
SYSTEM 
MANAGEMENT 


EY-J2554-A0 
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COURSE STRING 


RSX-11M 
DEVICE DRIVER 


EY-J2550-A0 


RSX-11M DESIGN OF 
OPERATING APPLICATIONS 


SYSTEM UNDER RSX 


INTERNALS EY-J2484-A0 
EY-J2552-A0 


PROGRAMMING 
RSX-11M IN 
FORTRAN/MACRO 


EY-J2556-A0 


PROGRAMMING 
iN FORTRAN IV 


IN MACRO-11 


EY-J2050-A0 


EY-J0016-AO 


RSX-11M/M-PLUS 
UTILITIES AND 
COMMANDS 


EY-J2536-A0 


PDP-11 CONCEPTS 


EY-J2048-A0 


INTRODUCTION TO 
MINICOMPUTERS 


EY-J2016-A0 
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RSX-1LIM/M-PLUS SYSTEM OVERVIEW 


INTRODUCTION 


Every computing system is designed for a _ purpose. This 
purpose determines how the system component parts are assembled to 
make a unit workable. The RSX-11M/M-PLUS Operating Systems were 
designed to solve real-time problems, those often requiring 
complete dedication to the computer's’ resources. This module 
explains: 


1. How the operating system keeps track of your program 


2. How it allocates the CPU and memory to your program when 
requested to run 


3. How it decides who gets CPU time and memory space when 


programs are competing for these resources. 


An understanding of the processing philosophy of this 
operating system will help you compare the differences between 
this and other operating systems used with PDP-1l hardware. 


OBJECTIVES 


l. List the characteristics of the RSX-11M/M-PLUS operating 
system. 


2. List the facilities available with RSX-11M/M-PLUS and the 
documentation provided. 


3. Describe the resource management techniques’ used by 
RSX-11M/M-PLUS for CPU and memory. 


4. List the various states of an RSX-11M/M-PLUS task and how 
each affect task execution. 


5. State the difference between a mapped and unmapped 
operating system. 


6. Define the terms virtual and physical address and_ state 
how they apply to a task and physical memory. 


LS 
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RESOURCES 


In order to complete this unit, you must have access to. the 
Eollowing document: 


Introduction to RSX-11M and RSX-11M-PLUS 
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OVERVIEW 


A computer system consists of two essential components, the 
hardware and the software. 


The Hardware 


The hardware can consist of any combination of a CPU, memory 
and peripheral devices depending upon your site requirements. One 
important feature of the PDP-1l1 hardware architecture is_ the 
ability to easily add peripheral devices to a configuration, but 
only the devices necessary to a given application. Like a 
fingerprint, each PDP-11 hardware configuration can be unique. In 
addition to a Central Processing Unit (CPU), memory, and a 
communications link between all the hardware devices, the system 
may have a mix of the following devices: 


- Disk drives 

- Floppy disk drives 

- Magnetic tape drives 

- Hardcopy terminals 

- CRTs 

~- Line printers 

- Paper tape readers and punches 
- A/D converters 


- Communication Interfaces 


The Software 


The hardware alone is not enough to make a computer a_ useful 
tool. Without software to allow the printer to print, a terminal 
to send and receive data, and a magnetic tape drive to capture 
information, the hardware would remain just hardware. It is the 
software coupled with the hardware that makes the computer a 
useful tool. In general, the software is the instructions 


(programs) executed by the computer system to perform a perticular 
function. 
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THE OPERATING SYSTEM 


Having the hardware and software alone does not guarantee 
rapid, easy development and execution of programs. An additional 
element is needed to tie these two together. Coordinating the 
many activities and features of the hardware and software, and 
managing these resources at computer speeds is the task of the 
operating system. 


An operating system is a collection of programs that 
organizes a set of hardware devices into a working unit which 
people can use. It generally consists of two parts: 


- An Executive 


- A set of System Utilities 


The Executive acts as the primary interface between the 
hardware and a program running on the system, and between the 
program and the people who run the program. The basic’ functions 
of the Executive are: 


Scheduling of the CPU 

- Allocation of physical memory 

- Geanynaduate interface 

- Device/data management 

- Program processing facilities 

There are many operating systems that will execute on the 


PDP-1l hardware. Table 1-1 lists those that are currently 


Supplied by Digital Equipment Corporation. Each was developed for 
a particular processing environment. 


LEARNING ACTIVITY 


For further information regarding each 
operating system, READ the respective 
chapters in the PDP-11l Software Handbook. 
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Table l1-1l 
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RSX-11M/M-PLUS SYSTEM OVERVIEW 


THE RSX-11M-PLUS OPERATING SYSTEM 


Every operating system's architecture is built around ' some 
processing philosophy. The RSX-11M/M-PLUS operating systems are 
two of many operating systems that will execute on the PDP-1l 
hardware. Your organization purchased the RSX-11M/M-PLUS 
operating system because its processing philosophy fits the 
application for which it was purchased. The following list shows 
the characteristics of the RSX-11M/M-PLUS operating system. 


RSX-11M/M-PLUS Characteristics 


e Real-Time - The operating system is designed primarily to 
handle the execution of real-time taskS as opposed to 
tasks that lend themselves to a time-sharing system. 
Real-time tasks are critical tasks that need exclusive use 
of the system resources on short notice and until they are 
no longer needed. In this type of a system, a task gains 
control of the CPU by priority and keeps CPU control until 
it completes, aborts, or some significant event occurs. 
Also, when the system is not servicing real-time tasks, 
the CPU's idle time can be divided into time slices and 
shared among tasks that lend themselves to a time-sharing 
environment, such as editing programs. 


e Multiprogramming -—- RSX-11M/M-PLUS allows more than one 
task to be resident in memory and competing for CPU time. 
The CPU is the most important resource in a computer 
system. Having many tasks resident in memory at the same 
time minimizes CPU idle time. 


e Multiuser - RSX-11M/M-PLUS allows more than one person. to 
be able to use the system at one time. Each individual 
can be sitting at a terminal performing work, and it will 
appear that the system is dedicated to him alone. 
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Interactive - Being able to talk directly to the operating 
system allows the user’ to interact with each step in a 
process. It can be verified that the step was executed 
correctly before proceeding on to the next step. This 
flexibility is not available in a batch system, where’ the 
complete job stream is executed whether or not there was 
an error in the first step. 


Disk-Based - The tasks that make up the RSX-11M/M-PLUS 
operating systems are resident on a disk pack, and read 
into memory from this disk when needed. The disk is also 
used to temporarily store tasks when freeing up memory 
space for higher-priority tasks. It also provides a_ file 
Structure for maintaining usSer programs and other files. 


Intertask Communication - A task executing under’ the 
RSX-11M/M-PLUS operating system has the ability to pass 
data on to another task, can cause another task to begin 
execution, and can notify another task that a certain 
event has occurred. 
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RSX-11M/M-PLUS Components 

Although we generally think of an operating system as a 
Single entity, it is really comprised of smaller pieces that are 
closely associated with each other. The two major groupings of 
these pieces are the Executive and the supporting utilities. 


The Executive is the root of the operating system and is 
always resident in memory. It is made up of the following parts: 


@e Executive 
- CPU Scheduler 
- Memory Allocator 
- System Services (Directives) 
- System Software: 
- Command Line Interpreters 
DCL 
MCR 
User-supplied 
- FILES-11 Data and File Manager 


- Device Drivers 


The second group, supporting utilities, only becomes memory- 
resident when a request for its services is made. 


e Supporting Utilities comprise: 
- Program Development Tools 
TEXT Editors (EDI, EDT) 
MACRO-11 Assembler 
Task Builder 


Librarian 


System Macro Source, Object, and Universal 
Libraries 
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- High-Level Languages (Optional) 


FORTRAN IV 
FORTRAN IV-PLUS 
FORTRAN-77 
COBOL 

BASIC-11 
BASIC-—PLUS-—2 


- File Maintenance Tools 


Backup and Restore Utility (BRU) 
Peripheral Interchange Program (PIP) 
File Transfer Program (FLX) 

Print and Queue Utility 

Queue Manager (QMG) 


- Volume Maintenance Tools 


Disk Volume Formatter (FMT) 

Bad Block Locator Utility (BAD) 

File Structure Verification Utility (VFY) 
File Dump Utility (DMP) 

Disk Save and Compress (DSC) 


- Program Maintenance Tools 
File Compare Utility (CMP) 
Source Language Input Program (SLP) 


Object Module Patch Utility (PAT) 
Task/File Patch Program (ZAP) 
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Documentation 


A complete set of documents is supplied with each operating 
system that DIGITAL ships. The documents contain information on 
all the facilities available to the user. There are seven volumes 
in the set, each containing one or more manuals. Their 
organization is shown in Figure 1-l. Sheet three of this figure 
shows the documentation available for languages that are available 
under separate license. Your computer center will only have the 
documentation for those languages which you have purchased. For 
your convenience, Figure 1-2 indicates the recommended Sequence 
for reading the manuals. You should read the 
RSX-11M/M-PLUS Information Directory first. The release notes 
will provide information on changes in the operating system that 
are included in this version. 
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The Documentation 


Figure 1-1 
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Figure 1-2 Sequence for Reading Manuals 
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Other Resources 


In addition to the system documentation set, the following 
are other resources to increase your system knowledge. 


1. 


RSX-11 Technical Summary - A technical introduction to 


many aspects of the three RSX real-time operating systems 
including information = and Digital Support Services 
available with RSX systems. 


PDP-11 Processor Handbook - A discussion of the various 


features of each PDP-11 CPU, the instruction set, UNIBUS, 


programming techniques, memory management, commercial 
instruction set and instruction timing. 


PDP-1l Software Handbook - A discuss¥ion of the major 
operating systems, programming languages, file and record 
management, data base management, utilities and 


interprocessor communication available on the PDP-11l. 


DECUS - The Digital Equipment Computer User's Society - A 
worldwide association of customers and employees providing 
a forum for the exchange of useful information, new 
program packages and other innovations. (Membership is 
free to owners of DIGITAL computers.) 
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THE OPERATING SYSTEM 


Before the operating system can be loaded into the computer's 
memory, your system manager (the person reSponsible for the 
operation and maintenance of the system) goes through a _ procedure 
called system generation (SYSGEN). This procedure builds the 
operating system, and fine tunes it with the hardware and software 
requirements of your computing site. At the end of the SYSGEN, 
the executable image of the operating system is written to a_ disk 
called the system disk. To start the computer operation, this 
executable image must be loaded into memory and an _ instruction 
issued to start the operating system executing in the central 
processor. This procedure is called "booting the system". 


Memory Use 


One of the resources that the operating system must manage is 
memory. Figure 1-3 shows how memory is used. Depending upon the 
operating system and the hardware, the amount of memory that’ can 
be connected can range from l16KW to 2MW. The operating system 
always resides in the low addresses of memory, and can range in 
size from 16KW to 2@KW, depending on the software and hardware 
options generated in the SYSGEN_ process. Part of that 2@KW 
(maximum) iS an area called Pool or Dynamic Storage Region (DSR) 
set aside for the dynamic storage of executive data structures 
(These are little lists that the operating system uses to keep 
track of information about tasks and devices.) The top 4KW of 
physical memory addresses are reserved for the I/O page and are 
not available for general use. The remainder of memory is 
available for user programs. 


MEMORY 


R = REMAINDER FOR 
USE BY THE 
USER 


Dagrowrs Ce Storage Resrow 
16K < N < 20K 


RSX-11M/M-PLUS 
EXEC 
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Figure 1-3 Memory Use 
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Tasks 


The smallest executable piece of code on this’ operating 
system is ae task. Tasks are problem solutions that have been 
processed through the program development cycle producing an 
executable task image (Figure 1-4). For this problem solution to 
execute in the CPU a user must make a request to the operating 
system to run that program. It is the operating system's 
responsibility to locate the task image on disk, check’ the 


availability of memory space, load the task into memory, and 
schedule the task to run. 


Examples of tasks: 

- Payroll Program 

- Text Editor 

- FORTRAN Compiler 

- Monitor Console Routine 

- File Maintenance Program 

- Data Analysis Program 

A task is built with two (or many) attributes that’ the 
operating system uses to schedule that task to run. These are the 
priority at which the task will run and the area in memory where 


it will be loaded (partition). Before a task can be run on the 


system, the operating system must know this information (and more) 
about it. 
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Figure 1-4 A Task is the Result of Program Development 
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Steps Required to Run a Task 


1. A request-to-run must be issued for the task. 
2. System checks to see if it "knows" this task. 


3. System adds the task to a list of active tasks competing 
for resources. 


4. Task image must be loaded into memory from disk. 


5. Task is scheduled for CPU time. 


The System Task Directory (STD) 


The operating system maintains a list of known tasks’ within 
the area called Pool. This data structure is called the System 
Task Directory (Figure 1-5) which is a linked list of another data 
structure called the Task Control Block (TCB). The TCB contains 
such task information as the task name, the priority at which it 
will run, the location in memory where it will be loaded, and the 
disk address where the task executable image can be found. All 
tasks to be run on the system must have this information recorded 
in the STD. This process is called installing a task and is 
accomplished by the INSTALL operating system command. (Installing 
a task does not cause it to run.) Some tasks are permanently 
installed, and others temporarily installed in the STD for the 
time they are executing. 


Active Task List (ATL) 


When a uSer requests a task to be run, the operating system 
creates an entry into another data structure maintained in Pool 
called the Active Task List (Figure 1-6). This is a list of all 
tasks competing for the system resources (i.e., Someone requested 
the task to run) at any one time. 
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NAME = ...DCL 
PRI = 160. 
PAR = GEN 
DISK ADDR = 
SYO: -01132456 


NAME = ... MAC 
PRI = 50. 

PAR = GEN 
DISK ADDR = 
SY0: -00000557 
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Allocating Memory to a Task 


Before a task can gain control of the CPU and begin 
executing, it must be resident in memory. In other words, the 
operating system must determine the addresses where the task will 
be loaded into memory and then check to see if those addresses are 
available for use. TaskS compete for memory space by the _ task's 
priority and the partition of memory in which it has been built to 
run. A task can be built with a priority from 1 to 258. 
Real-time tasks are generally given a priority within the range of 
15@ - 25@. 25@ is the highest priority. Most tasks run at a 
priority of 5@, which is the default priority for a task. 


Figure 1-7 shows the priority range; notice that the Digital 
Command Language (DCL) runs at a priority of 248, while the Editor 
runs at a priority of 65. This means that when the operating 
system is looking for a task to run in the CPU, it will choose the 
Task Loader over the Editor if both are competing for the CPU. 
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FOR TIME 
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USED TASKS 50. DEFAULT PRIORITY 
FOR A TASK 
1: 
PRIORITY 
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Figure 1-7 Tasks are Built with a Priority 
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Partitions 


Tasks also compete for memory space depending upon the 
partition in which they were built to run. A partition (Figure 
1-8) is a contiguous section of memory. The operating system 
takes up 16 to 2@KW of low memory addresses, and the I/O page 
takes up the top 4KW. During SYSGEN, the system manager, taking 
into account your site requirements, divides up the remaining 
portion of memory into sections giving them a name, starting 
address, size and type. These sections of memory, called 
partitions, can be changed by the system manager when necessary. 


In Figure 1-8 there are six partitions listed. Tasks can _ be 
loaded into each of these partitions. For example, DRVPAR is a 
special partition in which the code loads that controls’ the 
operation of devices (such as your terminal, disk drives, etc.). 
Generally, no other tasks are built to be loaded into this 
partition. 


The default partition (GEN) is the one you get if you do not 
specify a partition when you build your task. Generally, most 
tasks are built to load into this partition and, therefore, 
compete with each other for this memory space when they are 
requested to run. 


Figure 1-9 shows some _ tasks and their corresponding 
partitions. Notice that the Task Loader (...LDR) has its own 
partition. This task is the routine that loads all other’ tasks 
into memory. It is used often, so speed is important. To ensure 
that it always has a spot in memory in which to load, and does not 
have to compete with other tasks for that spot, a special 
partition was created just for it. This guarantees that’ the 
loader is available to load tasks when needed. 


The size of a partition determines if more than one task _ can 
be loaded into it.. The GEN partition is usually large enough to 
handle many tasks at one time. The number of tasks is dependent 
upon: how much memory is allocated to the partition (partition 
size), the mix of the number of tasks requested to run in the 
partition and their sizes, and the type of partition. On RSX-11M 
systems there are two types of partitions, user-controlled and 
system-controlled. RSX-11M-PLUS systems only have’ system- 
controlled partitions. 
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Table 1-2 lists the differences between system- and 
user-controlled partitions. The major difference is in the way 
partitions are subdivided. In a system-controlled partition 


(Figure 1-18), Subdivision is done dynamically to accommodate the 
mix of tasks that have been requested to run in the partition at 
the time. At another time, the number of subpartitions and their 
sizes will be quite different, depending upon the mix of tasks 
again. In a user-controlled partition (Figure 1-11), the 
Subpartitions are generated statically at SYSGEN time. There can 
be aS many aS seven’ Subpartitions. The subpartitions can be 
changed but do not change dynamically at run time to accommodate 
different sized tasks. A task can be loaded into the main 
partition, in which case the Subpartition will remain unavailable; 
or a task can be loaded into each of the subpartitions, in which 
case the main partition iS unavailable. 
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Figure 1-8 Memory Divided Into Partitions 
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Figure 1-9 Tasks Execute in a Specific Partition 
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Table 1-2 Characteristics of System- 
and User-Controlled Partitions 
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Figure 1-18 Running Tasks in a System-Controlled Partition 
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Figure 1-11 Running Tasks in a User-Controlled Partition 
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Checkpointing 


A task's ability to remain in memory (discounting the 
condition of completion or aborting) depends upon another concept 
called checkpointing. Checkpointing is the removal of a task from 
its partition (before it has completed execution) and temporarily 
storing its memory image on disk to allow a higher-priority task 
to replace it in the partition. Figure 1-12 shows this procedure. 


1. TASKA has been built for XYZPAR with a priority of 5@. A 
request to run TASKA is made. Free space is available in 
the partition, so TASKA is loaded into memory. 


2. TASKC has also been built to run in XYZPAR but has a 
priority of 8@. A request to run is made for TASKC. 
There is room in the partition for both tasks, so TASKC is 
loaded. 


3. TASKB, which also has been built to run in the XYZPAR 
partition, has been requested to run. The operating 
system, in finding that there is no room in the partition 
to load the task, checks’ to see if there is a task of 
lower-priority that it can remove temporarily to 
accommodate TASKB. It determines that TASKA meets those 
requirements, copies TASKA'S memory image to ae file 
(called the system checkpoint file) on disk, and then 
loads TASKB into the partition. TASKB then competes’ with 
other active tasks for CPU time. 


4. When space becomes available again, TASKA's saved memory 
image will be loaded back into the partition from the 
checkpoint file, and TASKA will again compete for CPU 
time. 
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Figure 1-12 Checkpointing a Task 
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Shuffling 


Tasks are constantly being loaded, checkpointed and 
completed. When activity in a partition continues like this for a 
period of time, fragmentation of unuSed space can occur, as _ shown 
in Figure 1-13. In the partition, APAR, there is 7KW of unused 
Space that could be used to load another task. However, because 
it is not contiguous space, it prevents another task from being 
loaded. There is a system routine called the SHUFFLER- that 
corrects this fragmentation problem within a system-controlled 
Partition. Figure 1-14 shows the function that the SHUFFLER 
performs. 


1. Due to heavy activity on the partition, there are _ two 
sections of memory available, a 1K section and a 3K 
Section. Together the space would be large enough to load 
in TASKZ. However, because the space is not in one 
section, TASKZ is blocked from being loaded into memory. 


2. When the shuffler is invoked by the operating system, it 
searches through the partition for free space. When space 
is found, tasks are moved down so that the free space (in 
this case, 4K of free space) is in one area. Then TASKZ 
is no longer blocked and can be loaded into the space. 
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Figure 1-13 Partition Fragmentation 
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Figure 1-14 Partition Shuffling to Obtain Contiguous Memory 
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Allocating CPU Time to a Task 


Once a task haS won a spot in memory, it is then able to 
compete for CPU time. A task is given control of the CPU based 
upon its priority and its task state. The CPU is always given to 
the highest-priority, ready-to-run task. The operating system 
schedules the CPU at certain intervals called significant events 
(Table 1-3). Whenever a Significant event occurs, the operating 
system reconsiders the state of all active tasks and determines 
which task will be given the CPU. 


Figure 1-15 shows the different states of a task: 


1. KNOWN - A task that has had an entry placed in the System 
Task Directory (STD). The INSTALL system command is used 
to create a TCB with a task name, priority, partition and 
disk address, and then links the TCB into the STD. 


2. UNKNOWN - A task that has not been installed in the _ STD. 
There are many more unknown tasks in the system than there 
are known tasks. 


3. ACTIVE - An installed task that has been requested to. run 
and is competing for system resources. 


4. DORMANT - An installed task that has not been requested to 
run. 


5. RUNNABLE - An active task that is ready-to-run. 


6. CURRENT - An active task that currently has control of the 
CPU. 


7. BLOCKED - An active task that is kept from running due to 
lack of resources. 


A task changes state when some event applies to it. For 
example, an UNKNOWN task becomes KNOWN when the INSTALL command is 
used to make it known. A KNOWN taSk becomes ACTIVE when a_e user 
requests it to be run with the RUN command. An ACTIVE task 
becomes RUNNABLE when all the resources it needs are available. 
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UNKNOWN KNOWN 


ACTIVE 


DORMANT 


EXECUTIVE 
GRANTS CPU 


REMOVE EXECUTIVE 
GRANTS CPU 


TO OTHER TASK 


TASK WAITS 
FOR EXTERNAL 


EVENT 
REQUIRED 


EXTERNAL 
EVENT OCCURS 


BLOCKED 


@ A TASK REMAINS ACTIVE FROM THE TIME IT IS REQUESTED TO 
RUN, UNTIL THE TIME IT EXITS OR IS ABORTED. 


@ THERE MAY BE ANY NUMBER OF ACTIVE TASKS AT A GIVEN TIME. 
THERE 1S ONLY ONE CURRENT TASK AT ANY GIVEN TIME. 


OPERATING SYSTEM COMMAND USED TO 
CHANGE THE STATE OF A TASK. 


2) TASK COMPLETES EXECUTING AND 
ITS STATE CHANGES. 
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Figure 1-15 Task States 
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Table 1-3 Significant Events that Cause Rescheduling of the CPU 


ro 


mes 


es 
= 
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Round Robin Scheduling 


When the CPU is idle and not servicing real-time tasks, its 
time can be divided among many tasks giving each a slice of time 
in which to execute. This time-sharing method of scheduling CPU 
time is implemented through the round robin scheduler. It is a 
system generation option that your system manager most generally 
will incorporate into your operating system. It only applies to 
tasks running within a certain range of priorities set up by the 
system manager. Generally, that range is from 1 to 15@. 
Real-time tasks are never considered in this scheduling algorithm. 
At a set interval, the round robin scheduler executes in the 
manner shown in Figure 1-16. 


1. Round robin scheduler traverses the ATL looking at tasks 
within a priority. 


2. Within the priority, the scheduler will rotate the 
positions of the tasks, so that the first task in the list 
becomes the last task within the priority, the second task 
then becomes the first task within the priority, etc. 


3. The scheduler then moves on to the next priority and 
rotates the task's position in the same manner. 


The procedure allows for fair distribution of CPU time among 
tasks within the same priority. Without the round robin 
scheduler, the first task in the priority range would always get 
the CPU until it completed or aborted. Then the second task in 
the priority range would get control. 
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TASKA TASKB 


TASKC 
PRI = 100. PRI = 100. 


PRI = 100. 


0 
(END OF LIST) 


ACTIVE TASK LIST BEFORE AN EXECUTION OF THE ROUND ROBIN SCHEDULER. 


TASKB TASKC | TASKA 
PRI = 100. PRI = 100. PR! = 100. 


TASKE 0 
PRI = 50. (END OF LIST) 


ACTIVE TASK LIST AFTER AN EXECUTION OF THE ROUND ROBIN SCHEDULER 
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Figure 1-16 Round Robin Scheduling 
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Task Addresses 


When a task is developed, source code instructions’ get 
converted into machine instructions, each with an address. These 
addresses are referred to aS virtual addresses; that is, they are 
not the final addresses, or they do not refer to the actual 
physical memory address of where the program will reside. They 
are the addresses used in listings, debugging, etc. A program's 
virtual addresses can range only from @ - 177777 (@-32KW). Figure 
1-17 depicts the concept of a task's virtual address space. 


THE SOFTWARE 


A PROGRAM'S ADDRESSES (ALWAYS 
REFERRED TO AS VIRTUAL ADDRESSES) 
CAN ONLY RANGE FROM 0-177777g 
(0-32KW 49) ON A PDP-11 


PGM.TSK 
177777 
PROGRAM'S 
VIRTUAL 
ADDRESS 
SPACE 
V.A. 0 
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Figure 1-17 Virtual Address Space 
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Physical Addresses 


The physical address refers to the actual physical memory 
location (Figure 1-18) where a task resides. Physical addresses 
can range from @ to 2MW. This range is determined by the actual 
amount of memory on your system. 


Because the PDP-1l hardware is a 16-bit architecture, and the 
largest address that can be contained in 16 bits is 65,536 KBytes 
or 32K words, if you wish to access a memory location larger than 
32K words, you need some assistance. This assistance comes 
through adding the KT-11 Memory Management hardware to the system. 
A computer system without this hardware is called an unmapped 
system and will have at most 32K words of memory. A _ system with 
this hardware is called a mapped system and can have as much as 2 
megawords of memory. 


When a program is loaded into memory, the operating system's 


responsibility is to map the program's virtual address into the 
physical memory location where it will reside. 


THE HARDWARE 


MEMORY 


2MW 
1/0 PAGE 


RSX-11M/ 
M-PLUS 
OS. 


P.A. 0 


PHYSICAL ADDRESSES ARE DEPENDENT 
UPON THE ACTUAL AMOUNT OF PHYSICAL 
MEMORY ON YOUR SYSTEM. 


ADDRESSES CAN RANGE FROM 
0-32 KW (UNMAPPED SYSTEM) 
0-2 MEGAWORDS (MAPPED SYSTEM) 
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Figure 1-18 Physical Address Space 
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Mapped Systems 


A PDP-11 system that has the KT-11 Memory Management hardware 
attached is called a mapped system. This hardware provides for 
the conversion of a 16-bit virtual address into an 18- or 22-bit 
physical address. This feature allows a task to address a memory 
location greater than 32K words and also to have up to 2 megawords 
of memory on the system. The KT-11l hardware also provides for the 
relocation of tasks in memory because an absolute physical address 
need not be built into the task's image. The operating system in 
conjunction with the KT-1l hardware generates’ the physical 
address, indicates where to load the task, and then later, if 
necessary, is able to move the task by remapping the task 
addresses (Figure 1-19). The KT-ll hardware also_ provides 
security by checking for memory protection violations by a task. 


PHYSICAL MEMORY 


PROG.TSK K I/O PAGE 
17777 Ss Tt 
I~ 
. 200000. 
4KW A 
TASK 
IMAGE 2 160000_ 
" ac re 
_— 
A} -—— 150000 
R 
V.A. 0. _— 
140000 
— — 


120000 
RSX-11M/M-PLUS 20KW 
EXEC 
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Figure 1-19 Mapping a Virtual Address Into a Physical Address 
on a Mapped System 
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Unmapped Systems 


An unmapped system is one without the KT-1l1 hardware and, 
therefore, can have at most 32K words of memory attached to it. 
Tasks on this system are built to load at an absolute physical 
address (Figure 1-20). Task addresses map directly to their 
physical addresses. To run the task at another physical address, 
the task must be rebuilt using the new desired address. 


PHYSICAL 
MEMORY 


I/O PAGE 


177777 


160000 


PROG.TSK 
140000 ~ 
ae — 160000 
ee sei RTPAR 
4k 140000 
TASK XYZPAR 
IMAGE 120000 4K | 
_— 
_— eo 
abe RSX-11M 
120000 Le EXEC 
0 


TK-7714 


Figure 1-28 Task Built to Execute on an Unmapped System 
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ON THE SYSTEM 


GETTING STARTED ON THE SYSTEM 


INTRODUCTION 


You interact with your RSX-11M/M-PLUS system through a 
terminal at which you type commands. Most typed commands are 
processed by the Command Line Interpreter (CLI). 

In this module you study the basics of terminal interaction 
including: 1) the conventions available for terminal use and 


communication with system-supplied CLIs, 2) how to issue system 
commands, and 3) how to get on-line system assistance. 


OBJECTIVES 
1. Log on and off an RSX-11M/M-PLUS system. 
2. Control terminal behavior using control characters. 
3. Use system HELP facilities. 
4. Invoke system operations using MCR or DCL commands. 


5. Switch Command Line Interpreters. 


RESOURCES 


1. RSX-11M/M-PLUS MCR Operations Manual 


2. RSX-11M/M-PLUS Command Language Manual 
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LOGGING ON THE SYSTEM 


Before you can attempt to do any work on the system, you must 
go through a_ procedure called "logging on" in which you supply 
information when prompted by the operating system. This logging 
on procedure identifies you as a valid user of the system. One of 
the features of an operating system in a multiuser configuration 
is system security. By asking for your name and password and 
comparing this to information stored in the computer by your 
system manager, the operating system can verify whether you are a 
valid user. If you are a valid user, the operating system 
performs some initialization steps, and then grants you access to 
the system resources. 


Before you can attempt to log on to the system, you must’ ask 
your system manager to set up an account for you in the system 
accounts’) file. The accounts file contains the Eollowing 
information about each authorized system user: 

- User Identification Code 

- User Name 


- User Password 


- User Default Command Line Interpreter (CLI) 
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User Identification Code (UIC) 


The User Identification Code is a number assigned to a _ user 
that uniquely identifies him from other users of the system. 


It has the form [g,m] where: 


g = an octal number from 1-377 
that defines a group of 
users. 

m = an octal number from 1-377 


that uniquely identifies 
a group member. 


A group number is uSually assigned to a particular group of 
users such as the payroll department, or the production group. 
Each user in each of these departments would have his own unique 
member number. Suppose the production group was given a group 
number of 385 and you, a member of that group, were given a member 
number of 7. Your UIC would then be [385,7]. Suppose that the 
payroll department was given the group number of 218 and = your 
friend, a member of that group, was assigned the member number of 
185. His UIC would then be [219,105]. This number is used _ to 


keep track of all the privileges and information that you have 
stored in the system. 


Passwords 


When your system manager sets up an account for you, he will 
ask you to supply him with a string of six characters (or less) 
that will constitute your password. This string of characters 
will have to be supplied every time you log into the system. It 
is not echoed (i.e., displayed on the terminal) by the operating 
system when you respond to the password prompt. The operating 
system will check the accounts file to see if the password 
supplied with the UIC or name matches exactly with what is stored 
there. If it does not match exactly, access rights to the system 
resources will not be given to you. Your paSSword can be changed 
by the system manager at any time if you request it. 
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Command Line Interpreter (CLI) 


Once you have successfully logged into the system, a_ routine 
called a Command Line Interpreter (CLI) becomes active at your 
terminal. This routine will accept commands made up of keystrokes 
and a line terminator from your terminal, do some interpretation 
on the command line and pass it along to the operating system for 
action. There are two different CLIS available with the operating 
system; computing sites may write their own interpreter. You 
must tell your system manager (when he creates your account) which 
one of these interpreters you wish to have active at your terminal 
when you log in. This will become your default CLI, discussed 
later in this module. 


Notes on Example 2-1 


Example 2-1 shows the log in procedure. The following 
comments are keyed to the example. 


@ User logs in (LOGIN or HELLO), supplying system with a 
UIC. 


User supplies his password, but the operating system does 
not echo the characters. 


Message indicates what system is being logged into, the 
date, time and terminal number. 


@ System messages displayed at terminal. 
@ user logs off the system. (LOGOUT or BYE) 


User logs on uSing the slash (/) as a delimiter in the UIC 


to Suppress system messages. You will notice that the 
messages Shown in note 3 above are not displayed this 
time. 


User logs on using uSer name instead of UIC. 


8 | User logs on, system prompts for the account or name _ and 
the password. 
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LOGIN 305.303 
Fas¢eword | —_—_i 


RSX~LiM BL32 C2954] System QUASAR 
06-JAN-82 20302 Logged on Terminal TT36: 


Good Evenings 

6-JAN-S81 Kogan 
QUASAR will be down FRIDAY (JAN/B/82) from 11230 to 13300, 
Flegse let me know if vou heve any obJections, 

3O-TEC-81 Siler 


The DCL that’s mow in €2°54] (send installed by STARTUP) is built so 
that it vasses unrecognized commands to NCR. If your terminel is set 
to IiCL»s you can use whichever form of command it easiers MCR or DCL. 

LO 

Have 2 Good Evenings 

O6-JAN-82 20202 TTS6? logaed off QUASAR 

~LOGIN SO5/303 

Fassword ;} =i’ 


RSX-11M EBL32 [27954] System QUASAR 
O6-JAN-G2 207302 Loused on Terminal TTSé6é! 


Good Evening 


LO 

Have a Good Evenins 

06-JAN-32 20102 TTS4i lossed off QUASAR 
~HELLO EDSERY 

Fassword | = 


RSX-11M EBLS32 C2754] Sustem QUASAR 
O06~-JAN-82 20302 Lodded on Terminal TTS6: 


Good Evenings 
&~-JAN-81 Kogan 


QUASAR will be down FRIDAY (JAN/8/82) from 11330 to 13:00, 
Flesse let me know if you have ens obJections. 


3O-LTEC-81 Siler 
The DCL thet’s now in C2954] (end instelled be STARTUP) is built se 


that it Passes unrecognized commands to MCR, If sour terminal is set 
to [ItCL, you can use whichever form of command is easiers MCR or ICL, 


MCRiBYE 
Have » Good Evenings 
O6-JAN--82 20103 TT563 lossed off QUASAR 


Example 2-1 Logging on the System (Sheet 1 of 2) 
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© *Locin 
Account or mame? ELSERY 
Fassword: Si 


RSX-iiM EL32 [2°54] System QUASAR 
O46-JAN-82 20304 Lodged on Terminsl TTS6? 


Good Evening 
6-JAN-81 Kogan 


QUASAK will be down FRIDAY (JAN/8/82) from 11350 to 13300, 
Flease let me know if sou have any objections. 


30-DEC-81 Siler 


The TCL that’s now in C2954) (end installed by STARTUF) is built so 
that it rasses umrecodnized commands to MCR. If your terminal is set 
to TCLs vou can use whichever form of command it easier,s MCR or DCL. 


>BYE 
Have a Good Evening 
06-JAN-82 20:04 TTS46? logged of f QUASAR 


* 
“ 


Example 2-1 Logging on the System (Sheet 2 of 2) 
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Notes on Example 2-2 


Example 2-2 shows a sample terminal session. The following 
comments are keyed to the example. 


User logs on the system with his last name and password. 
He notes the system name and his terminal number. As this 
is the first time he logged in for the day he reads_ the 
system messages for important information. 


User issues the HELP command to see what information is 
available to help him learn the system. 


User decides he needs help using the Editor in DCL so _ he 
types the HELP EDIT command. 


User issues the SHOW USERS command to see who is’ logged 
one . 


User checks the time of day by issuing the SHOW DAYTIME 
command. 


User checks to see if there are any active tasks at his 
terminal. 


User then logs off the system. 
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1) “LOGIN ELSERY 
Fassword) a 


RSX-11M BL32 C2254] Suctem QUASAR 
06~JAN-82 20304 Lossed on Terminal TTS6! 


Good Evenins 
6-JAN-S1 Kogan 


QUASH@R will be down FRIDAY (JAN/8/82) from 11$30 to 13200. 
Flease let me know if you heave any ouJections. 


30-DEC-81 Siler 


The DCL that’s now in £2254] (end installed bye STARTUF) is built $0 
that it rasses unrecognized commands to MCR. If your terminal is set 
to ICL,» you can use whichever form of command is easiers MCR or DCL. 


© seve 


Hele is eveilable for many RSX-11M commands and utilities. 


For helr in loss#insg in to tne systems tyre HELP HELLO or HELP 
LOGIN. You’ll need an user-I0 and rassword to los in. 


RSX-11M systems have two meJor command landuades aor CLIs. 
These are MCR and [ICL. Once you led ins your terminal is set 
to @ither MCR or DCL. All terminals are set to MCR rrior to 
logging if. 


The general form of the HELF command is 
SHELPOC/clijd toric CsubtoricfsT] 
SHELF commandname Cawitchd 


Once you are logged ins you need mot include the mame of the CLI 

to which your terminal is set. For information on what further hele 
is avaeilsbles tyre HELFC/MCRI] LIST or HELF/DOCL, For se listing 

of helr available on other toricss tyre HELFOC/MCRI MORE or 

HELF/DCL MORE. You need mot los in tu get hele, 


© -HELF EDIT 
EDITC/aualifier] Ceommand lined 

7EDI 
/EDTC/eualifier€s J 
/KED 
/KS2 
/MAKE 
/MUNG 
/SLFC/aualifier€s ] 
“SOS 
*TECO 
/USINGiusereditor 


The ELIT command invokes an editor. Only EDI, ElT>s end SLE are 
surrorted on RSX-LIM/M-FLUS systems, KED and KS2 gre included with 
FMS-11 but ere not bundled. Aboreviation: E 


For Ettly and the unmsurrorted editors: the ortional command line is 3 command 
line to the editor which is rassed to it witheut eny checking whatsoever, 


Example 2-2 Sample Terminal Session (Sheet 1 of 2) 
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See HELP EDIT ET and HELP EDIT SLE for informstion om auslifiers 
available when invoking ET» the DEC Standerd Editors and SLF» the 
Source Landuase Ineut FProgtram. 


@ >show users 
HTO? £7230] 
TT6! £77374] 
TT11 €7/323 
TT12% £77302] 
TT13: £7742] 
TTAS? €7,1133 
TT16t £77103) 
TT20% £77263 
TT24 £79372) 
TT23t €301333] 
TT24t £16734] 
TT27? €7+3613 
TT47% £79573 
TTS2? £30476] 
TTSS! €7/32) 
TT56% £305-303] 

© *SHow DAYTIME 
11$12229 21-OCT-81 
‘>SHOW TASKS 
MCR... 
SHOTSS 
*LO 
Have a Good Mornings 
21-OCT-81 11:12 TT56: logged off QUASAR 


Example 2-2 Sample Terminal Session (Sheet 2 of 2) 


LOGGING OFF THE SYSTEM 


At the close of your working day or whenever you leave your 
terminal for any length of time, it is suggested that you log off 
the system. Logging off the system ends the terminal session and 
closes off access to your files, system files and privileges. You 
end the session by typing the BYE command, or if you are using DCL 
as your CLI you type LOGOUT. The operating system will type a 
greeting and then give you the date and time that you logged off 
the system. If you are running RSX-11M-PLUS, the system will also 
include accounting information for your terminal session. Example 
2-3 shows the two methods of logging off the system. 
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“LOGIN EISERYV 
Pacsword) Sa 


RSX-11iM BLY? C2254] System QUASAR 
O6-JAN-82 21207 Lossed on Terminal TT543 


Good Evenina 
6-JAN-81 Koen 


QUASAR will be down FRIDAY (JAN/8/82) from 11230 to 13100. 
Please let me know if you have any vbdections. 


3O-DEC-81 Siler 


The DCL that’s now in £2954] (end installed bye STARTUF) is built so 
that it Fasses unrecodnized commands bo MCR. If vour terminel is set 
to ICL» vou cam use whichever form of command is easier» MCR or IICL, 


>LO 
Have « Geod Evening 
O6-JAN-82 21307 TTS6:? lossed aff QUASAR 


“HELLO EDSERV 
Fassword: Si” 


RSX-i1M BL32 C2754] System QUASAR 
O6-JAN-82 21308 Lodsed on Terminal TTSS? 


Good Evenings 
6~JAN-81 Kogan 


QUASAK will be down FRIDAY (JAN/8/82) from 11330 to 13:00. 
Please let me know if vou heve envy obJections. 


SO-DEC-81 Siler 


The ICL that’s now in €2%54]) (end installed by STARTUF) is built so 
that it easses unrecognized commands to MCR. If your terminal is set 
to [CLs sou can use whichever form of command it easier» NCR or INCL. 


“BYE 
Have a@ Good Evenings 
OS6-JAN-82 21308 TTS6? losuged off QUASAR 


- 


Example 2-3 Logging Off the System 
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USING THE TERMINAL EFFECTIVELY 


Terminals 


Your terminal is your vehicle of communication with the 
operating system. Its capabilities extend beyond the function of 
responding to your keystrokes by sending the applicable signal to 
the operating system. Learning more about this device and its 
capabilities will make your sessions at the terminal more 
productive. 


Terminals are classified as either video (more commonly 
called Cathode Ray Tubes (CRTS) or hard-copy. Both have 
advantages and disadvantages. While CRTs generally transmit and 
receive at a faster rate, they do not provide a permanent record 
of a terminal session. Hard-copy terminals do provide a permanent 
record, but generally transmit and receive at Slower rates. They 
also require changing the paper occasionally, so a paper supply 
must be handy. Hard-copy terminals are also useful for those just 
learning the operating system. You may want to start out using a 
hard-copy terminal so that if you work yourself into a corner you 
will have documentation on how you got’ there. Your course 
administrator will be able to show you where you went wrong. 


Your terminal is made up of two independent devices: 
- an input device (the keyboard) and 


- an output device (a display - either a screen or a piece 
of paper) 


When you press a key on the keyboard, the terminal sends’ the 
applicable signal down the terminal line to the operating system. 
The operating system in return lets you know that it received that 
Character by sending it back where it is drawn on the screen (or 
typed on the paper). This process is called "echoing." You may 
have noticed during the log in procedure, that when you typed in 
your password, the characters did not echo at your terminal. This 
is to ensure the privacy of your password. 
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The arrangement of the keys on the keyboard may vary from 
terminal to terminal. Figure 2-1 showS an example of two 
keyboards. In addition to the keys found on a standard typewriter 
keyboard, a computer terminal has other keys that perform special 
functions such as starting and stopping output to the terminal, 
erasing typographical errors, retyping a command line, etc. It 
may also have an auxiliary keypad containing the numerical keys @ 
through 9, a decimal point, an enter key and arrow keys. Some 
system programs (like the editor) use this keypad for performing 
special functions. 


Table 2-1 shows the special keys and their function. Some of 
them require pressing two keys’ simultaneously to achieve the 
action; these are indicated in the table. When you are 
correcting errors within a command line be sure _ to use the 
<delete> key instead of the <backspace> key. Although’ the 
<backspace> key appears to perform correctly, it is not 
interpreted that way by the operating system. Table 2-2 shows how 
the delete key echoes on both a video and a hard-copy terminal. 
In the case of a video terminal, every time the delete key is 
pressed, the operating system (in particular, the terminal driver) 
transmits a command to back up the cursSor one position, and then 
transmits a space. In the case of a hard-copy terminal, the 
operating system transmits a backslash and then the last previous 
character is typed. 
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Figure 2-1 LA12@ and VT1@@ Keyboard Layouts 
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Table 2-1 Special Terminal Keys 
(Two Key Combinations) 
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Table 2-2 Echoing of Delete Key on CRTS/Hardcopy 


LEARNING ACTIVITIES 


1. READ the following sections in the 
RSX-1L1M/M-PLUS Command Language Manual: 


e 3.1, Logging In and Logging Out 
e 3.2, The Keyboard 


e 3.3, The Keypad 


e 3.4, The CTRL key and Control 
Characters 


2. DO the following at your terminal: 


a. Example 2-1 shows’ four different 
methods of logging in. Try each 
method using your UIC and last name, 
and decide which method you prefer. 
Ensure that DCL is active at your 
terminal. 


b. Table 2-1 lists special keys’ that 
help control the action of your 
terminal. Practice using each of the 
keys by issuing the following command 
when you have the system prompt: 


>TYPE LB:[1,2]DCL.HLP 


This file is a text file used by the 
HELP command to display the commands 
for which it has further information. 
Concentrate on how the keys control 
your terminal input and output. 
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CONVERSING WITH THE OPERATING SYSTEM 
Command Line Interpreter (CLI) 


CLIs are the languages used for communication between you and 
the operating system. On RSX-11M/M-PLUS systems, the user has the 
capability of talking to the operating system in more than one 
language. Two such languages are supplied by DIGITAL. They are 
the Digital Command Language (DCL) and Monitor Console Routine 
(MCR). You may talk to the operating system in only one language 
at a time, but can switch easily from one language to another. 
MCR is always present on your system. DCL most likely will be 
present, and your site may include a CLI not provided by DIGITAL. 
You may want to talk to your system manager’ regarding the 
availablity of CLIs on your system. We will discuss both DCL and 
MCR in this module and will use DCL throughout the course in 
listings and examples. 


CLI Prompts 


When the operating system is ready to accept commands’ from 
your terminal, it will display its default system prompt, ">", at 
the left-most position of your display. To determine which CLI is 
active at your terminal and to get the explicit CLI prompt, you 
Should type <CTRL/C>. Do this by holding down the control key and 
then typing the letter "C"., The operating system will then 


respond with the appropriate explicit prompt, either the MCR 
prompt: 


MCR> 
or the DCL prompt: 
DCL> 


You can perform this operation whenever you are unsure which CLI 
is active. 
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Default CLI 


The accounts file contains a default CLI for each user’ which 
is set up by the system manager when your account is created. 
When you log on the system, the accounts file is checked to. see 
which CLI is your default CLI. Once the log in procedure is 
complete, the operating system Starts your default CLI running at 
your terminal, and displays the implicit operating system prompt 
at your terminal. You are then ready to type system commands’ in 
the format required by the active CLI. 


Changing from One CLI to Another 
When you wish to change from one CLI to another you must 
issue the appropriate command. To change from DCL to MCR, type 
the following command: 
>SET TERMINAL/MCR 
To change from MCR to DCL, type the following command: 


>SET /DCL=TI: 


USING THE DIGITAL COMMAND LANGUAGE (DCL) 


The Digital Command Language (DCL) is the standard command 
language found on DIGITAL-supplied operating systems. Becoming 
familiar with this language will make your migration to other 
operating systems easier. The commands are more English-like, so 
most users prefer to use it. 
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Features of DCL 

e Standard command language used on most DIGITAL operating 
Systems. 

e English-like language. 

e Prompts for unsupplied information. 

@e Command line continuations: If the command requires more 
characters than will fit ona line, end the first line 
with a hyphen and continue the command on the next line. 

e Commands and keywords can be abbreviated (Four characters 
always sufficient since DCL ensures that first four 


characters are always unique). 


e Commands can be placed in a file and executed from that 
file. 


e HELP facility available for all DCL commands. 


e Can specify comments within the command line. 


The command line structure is shown below. 
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DCL Command Format 


1) 
> meemiiniiemeeeecenemen imma cneeernmee enema nme nnmeenameeenmmmmen 


>PRINT/COPIES:2 —_ A.FIN,B.FTIN <RET> 
000 0000 000 © 


>SHOW _TASKS/ACTIVE:TT31; <RET> 


° 000060 0060 © 
ees 
>COPY <RET> 


From? PCLS.DAT<RET> 
To? PGP.DAT<RET > 


Operating system prompt - Whenever it is present, commands 
may be entered 


DCL command - Can be abbreviated to at least 4 characters 
Command qualifier delimiter - Always a "/" 


Command qualifier - A keyword that further defines how to 
interpret the command 


Argument delimiter - Always a ":' 

Argument value 

Delimiter (blank or TAB) - Must be included 
Parameter 

List element delimiter 


Command line terminator 


@eo00q00qg000g00 0080 80 


Command line 
8@ 


GETTING STARTED ON THE SYSTEM 


Table 2-3 lists some DCL commands. Example 2-4 shows a 
sample session using these commands. Refer to the RSX-11M/M-PLUS 
Command Language Manual for additional information on each 
command. 


Table 2-3 Partial List of DCL Commands 


co 
oe 


oe ey 
EBS 


ee ee 
a be oS - 


ae : 
3 : 
Bis oe a G 
ee i Ena ns Ss 


? Zoe se OV i a 
ast pee oral ae 4 

: S 

Co ae 


ie 
oo 
oe 


tee 
ae ee oo 
Se 3 ae oe 
oo 


9 
os oo 
as ee ik 
a ee aS bee: 
eRe, 
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>SHOW, DAYTIME 
10350356 22-OCT-81 
>SHOW USERS 
HT13 £7222] 
TT63 €7%374] 
TT113 C7232) 
TT123 €7%302] 
TT13% €7%42) 
TT148 €72110) 
TT153 €72113) 
TT16$ €3012303) 
TT173 €723663 
TT213 C7372) 
T7223 £79116] 
TT233 €3012333] 
TT243 £52930] 
TT253 €301944] 
TT27$ €72361] 
TTS513 €100724] 
TTS33 €7%337] 
TTSS$3 C2201] 
TTS6$3 £3052303) 
>SHOW QUEUE 

¥*¥ PRINT QUEUES &x 
PRINT => LPO 


C77i13] DCLRES  ENTRY!433 ACTIVE ON LFO 
> 1 DROSC7/113IDCLRES. MAPS 41 

LPO = => LPO 

>SHOW TERMINAL 

TTS6% = £3057303] (3057303) 
CLI = BCL BUF = 132,  HFILL = 0 SPEED=( 960029600) 
LINES = 66. TERM = LA120 OWNER = none — BRO NOABAUD 


LOWER NOFRIV NOHOLD NOSLAVE NOESC NOCRT FORM NOREMOTE 
ECHO NOVFILL NOHHT NOF DX WRAP NORPA NOEBC TYPEAHEAD 


>SHOW TEV MM? 
MMO? TT23: ~- Frivate Mounted Loaded 
MM1$ Loaded 


Example 2-4 DCL Commands (Sheet 1 of 6) 
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>SHOW DEVICES 

HTO? Offline Loaded 

HT1: €7222] - Lodged in Loaded 

HT23 Offline Loaded 

HT3: Offline Loaded 

LPO? Loaded 

DBO: Loaded Tyre=RPOS 

[Bit Public Mounted Loaded Tyre=KF06 
DB2: Public Mounted Loaded Tyre=RP06 
UDO: Loaded 

DD1: Loaded 

TKO? Loaded 

DK1: Loaded 

likK2: Loaded 

DK3$ Loaded 

DLO? Loaded Tyre=RL01 

DL1: Loaded Tyre=RLO2 

tL23 Loaded Tyre=RLO1 

OMO? TTS1:3 - Frivate Mounted Loaded Tyre=RK06 
DM1! Loaded Tyre=RKOS6 

IM2:3 Loaded Tyre=RKO7 

PRO? Public Mounted Loaded Tyre=RPO7 
Ri: Loaded Tyre=RM03 

DSO? EMO? Ture=RS04 

nS13 EMO: Tyre=KS04 

DTO: Loaded 

NT1i: Loaded 

DX0? Losded 

UX13 Loaded 
EMO? Fublic Mounted Loaded Tyre=ML11 Size=4096. bilks 
MMOi TT23% - Private Mounted Loaded 
MM1: Loaded 

COO: Loaded 

NSO: Public Mounted Loaded 

TTO3 Loaded 

TT1i$ Loaded 

TT2: Loaded 

TT33 Loaded 

TT4! Loaded 
“TTS: Loaded 

NLO?3 

TIO’ 

CLO? LFO? 

LBO?’ DROS 

SYO3 DRO? 


Example 2-4 DCL Commands (Sheet 2 of 6) 
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>SHOW FARTITIONS 


CEXFAR 
TTPAR 

EXCOM1 
EXCOH2 
SYSPAR 
TKNFAR 
DRVFAR 


LDRPAR 
BASIC2 
FCSRES 
TSTFAR 
GEN 


NT.PCL 
NT.NSP 
NT. AUX 
POOL.. 


114734 
114670 
114624 
1145460 
114514 
114450 
114404 
114340 
114240 
114140 
114040 
113740 
113640 
113540 
113440 
113340 
113240 
113104 
112450 
112404 
112340 
112274 
112230 
112164 
045174 
061140 
046100 
046160 
046034 
100544 
0735740 
045430 
046370 
046270 
044770 
047560 
060534 
062220 
070214 
070750 
045240 
071730 
075014 
074554 
072450 
071040 
100610 
100500 
062634 
053244 
062264 
061074 
045034 


Example 2-4 


00115000 
00120000 
00160000 
00174700 
00203100 
00215100 
00225100 
00225100 
00227200 
00230400 
00233500 
00236500 
00237600 
00240700 
00242300 
00245000 
00247600 
00251100 
00255400 
00255700 
00260400 
00320400 
00360400 
00460400 
00460400 
00466700 
00507200 
00526500 
00572500 
00643600 
00666000 
90723600 
00767600 
019013600 
01046000 
01062100 
01111100 
01232000 
01257600 
013462200 
01516200 
01650500 
01760100 
02112100 
02172100 
02324400 
902402300 
02707700 
03671600 
03675300 
03713300 
03714400 
03776300 


00003000 
00040000 
00014700 
00006200 
00012000 
00010000 
00030600 
000021090 
00001200 
00003100 
00003000 
00001000 
00001100 
00001400 
00002500 
00002400 
00001300 
00004300 
00000300 
00002500 
00040000 
00040000 
00100000 
03317400 
00006300 
00014200 
00017000 
00044000 
00044000 
000134600 
00023300 
00044000 
00024000 
0009032200 
00014100 
00027000 
00044000 
000254600 
00020300 
00132000 
00132300 
00107400 
00055700 
00960000 
00132000 
00055700 
00132300 
00175700 
00003500 
00016000 
00001100 
90061700 
00001500 


DCL Commands 
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MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
SUB 


SUB 
SUE 
SUB 
SUB 
SUB 
SUB 
SUB 
SUB 
SUR 
SUB 
SUR 
SUE 
SUR 
SUB 
SUE 
SUE 
SUE 


(Sheet 3 of 6) 


COM 
TASK 
COM 
COM 
TASK 
TASK 
SYS 
DRIVER 
DRIVER 
DRIVER 
DRIVER 
URIVER 
IIRIVER 
DRIVER 
DRIVER 
DRIVER 
DRIVER 
DRIVER - 
DRIVER 
TASK 
COM 
COM 
TASK 
SYS 
CFMT +++) 
(EVP eee) 
(COT+s ++) 
(WKFFCF) 
(SYOFCF) 
(MTAACP) 
(RMHACF ) 
(UBIFCF) 
(QR2FCF) 
(QMNG.+4) 


' (LEO ) 


(RMDEMO) 
(FILACF) 
(NETACF) 
(SHOTS6) 
(+++ EDT) 
Coe oP IF) 
(HTL ) 
(EX ) 
(ee eATo) 
CENnTTIé) 
(EX2 ) 
(MAL +O ) 
(eee TRB) 
DYNAMIC 
DYNAMIC 
DYNAMIC 
DYNAMIC 


IRIVER ~-HT$ 


GETTING STARTED ON THE SYSTEM 


>SHOW TASKS INSTALLED 

LIR..+. 12.19 LIRFAR 248. 00002500 LBO!-01240437 FIXED 
TKTN 04.7 TKNPAR 248. 00010000 LBO?-01242244 
RMIEMO V1.05 GEN 225. 00027000 LBO{-01262570 
MTAACP 0013 GEN 200. 00013600 EMO$-00000325 
FiimMSG VOO0O12 GEN 200. 00005500 LBO?-01251052 
NETACF V02.00 GEN 200. 00025600 SY0%-01266761 
EVP... YO1.00 GEN 199, 00013100 SY03-01266561 
MCR.e+ 2.02 SYSPAR 160. 00012000 LBO’-01244424 

oo eMCR 1.1 GEN 160. 00020300 LEO0$-01244760 


SHOTSS 1.1 GEN 160. 00020300 LEO?-01244740 
0+ MOU 2503 GEN 160. 00037600 LEO:-00117642 
e+ eDCL 00 GEN 140. 00035600 SY0$-01132456 
e+ eHEL 01,0 GEN 150. 00037600 LRkO+-01250645 
ooeCAe 4.400 GEN 150. 00005100 LBO;-01251064 
ee eCfV¥T 4.02 GEN 150. 00052200 SY0$-01007774 
+e eDLG 4.02 GEN 150. 00052200 SY0?-01007774 
NVP... VO1.00 GEN 150. 00012700 SY03-01265031 
oe BYE 04.9 GEN 150. 900012500 SY03-01244767 
FLilACF M0401 GEN 149. 00044000 LE0O$-01247227 
WKFFCP M0401 GEN 149. 00044000 LEO} -01262523 
SYOFCF M0401 GEN 149. 00044000 EM03-00000260 
DB1IFCP M0401 GEN 149. 00044000 SY0}-01262313 
DB2FCF M0401 GEN 149, 00024000 SY0$-01262404 


PMT... 01.52 GEN 148. 900006300 LBO:-01246016 
ERRLOG Vi.04 GEN 148. 00040000 LBO’-01251006 


COT... 01.01 GEN 145. 00017000 LBO?-01250736 
oo DMO 23.25 GEN 140, 00014600 LEO? -91245770 
eeeINI 22.02 GEN 140. 00034600 LBO}-01246445 
eo eUFD V0412 GEN 140. 00005700 LBO?-01246615 
PMD... 07.2 GEN 130. 00017600 LBOQ?-01250210 
SHF..+ 5.08 SYSFAR 105. 00012000 LE0?-01250203 
eoeINS 06 GEN 100. 00034400 LBO?}-01243744 
oe eSEN 22JUL GEN 100. 00104400 LE0?-00662645 
RMHACP V02.00 GEN 100. 00023300 SY0i-01265073 
MALS$$$ L1IRX GEN 100. 00132300 SY0:!-004663342 
PMR$$$ VO1.05 GEN 100. 00034300 SY0?-00460507 
QMG... 1.8 GEN 70. 00032200 LBO?-01252004 
LPO 1.9 GEN 70, 00014100 LBO?-01252136 
PRT.e+ 142 GEN 70. 00001100 LBO?-01251443 
oe e+BRU 1,03 GEN 70. 00173500 LBO?-012546414 
eee KKK GEN 70. 00163400 DIK23-00010412 
e+e TEC V36 GEN 65. 00177100 EMO?-00001215 
+o eEDT M11.04 GEN 65. 00123600 EM03-00001371 
+¢+SOS 07.00 GEN 65. 00073300 EMO! -00001547 
e++EDT 02.00 GEN 65. 00132000 LBO’-01254476 
eoeMAI OLSEP GEN 65. 00123700 SY03-00555723 
RMT...» VO2.01 GEN 65. 00027300 SY03-01266505 
eeeRVT X02.19 GEN 65. 00032500 SY03-00663556 
ENTT1é6 02.00 GEN 65+ 00132000 LEO: -01254476 
eee AT. 02 GEN 64, 00060000 LBO{-01246107 
NTL+e+ VO2.00 GEN 60, 00036500 SY03-01265603 
NTINIT VO2.00 GEN S5- 00005000 SY0{3-01265347 
++¢BRO VO4 GEN 90- 00031000 LEO?-01250552 
LPINIT 01,03 GEN 50. 00016200 LBO?-01250260 


Example 2-4 DCL Commands (Sheet 4 of 6) 
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>SHOW TASKS /ACTIVE 
MCReee 

SHOTS6 

>SHOW TASKS /ACTIVE /ALL 
LDR ec 

RMDEMO 

NETACF 

EVP oes 

MCR.oe 

SHOTS6 

FiiAcr 

DBIFCF 

PMT eos 

COT... 

QMGe+. 

LPO 

oe EDT 

+eeATe 


Example 2-4 DCL Commands (Sheet 5 of 6) 


86 


GETTING STARTED ON THE SYSTEM 


>SHOW TASKS ACTIVE 
MCORo oe 
SHOTS64 
2SHOW TASKS ACTIVE AL 
LDIRe os 
RMDEMO 
MTAACF 
NETACP 
EVF eee 
MCReee 
SHOTSS 
FLLACP 
WKFFCF 
SYOFCF 
DEIFCr 
DB2FCF 
PMT eee. 
COT. ++ 
RMHACF 
QMG... 
LFO 
ee A TEC 
oo ELT 
EDTT16 
oo eATe 
oo 0 PIF 
eee TKB 
EX1i 
EX2 
EXST 
HT1 

> 


Example 2-4 DCL Commands (Sheet 6 of 6) 
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THE HELP COMMAND 


One of the most useful features of this operating system is 
the help that it provides on-line for the system commands. It is 
not necessary to search through manuals to find the correct format 
of a command or the qualifier that you need. By typing the HELP 
command in response to the system prompt, you will get a list of 
items for which the system has more information. HELP is the only 
command that you can type before logging onto the system. 


Examples of the HELP command are shown below. 


HELP Command Format 


>HELP<RET> 

>HELP/MCR HELLO<RET> 
>HELP SET<RET> 

>HELP SET TERMINAL<RET> 
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Notes on Example 2-5 


The following comments are keyed to the example. 


In response to the HELP command, the operating system 
displays the list of active CLI commands at your terminal 
for which it has information. 


To obtain information on any of those listed, type HELP 
and the command you wish the information for. Notice that 
the text gives you the syntax of the command and an 
explanation of what the command will do. 


To get help on a command of another CLI, use the /"CLI" 
qualifier shown here. Hello is an MCR command and is not 
listed in the HELP text shown in note 1 above. 


In this example, you will notice that the text includes 
the command qualifiers that can be used with the command. 


This and the following two examples show how to obtain 
further information on a command. Notice that the SET 
command has many attributes which it can change. To get 
further information, for example, on the TERMINAL 
attribute, you would concatenate this attribute to your 
original HELP command. 


This example shows how the procedure described above is 
accomplished. 


The HELP command is further qualified to obtain more 


information on setting the terminal, in particular the 
commonly used attributes. 
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@ 2HELF 


Hele is aveilable for the following I 


ABORT ALLOCATE APPEND 
BASIC BROADCAST CANCEL 
CONVERT COFY CREATE 
DEBUG DELETE DIFFERE 
EDIT FIX FORTRAN 
INITIALIZE INSTALL LIBRARY 
LOGOUT MACRO MCR 
FURGE RELEASE REMOVE 
RUN SET SHOW 
STOF TYPE UNF IX 


For information on @ commands tyre HE 
@ rarticular cualifier is often avail 


HELF commandname ausalif 
You can also det helr on ICL commands 


For information on utilities, system 
ture HELF MORE. For the short forme o 
For helyr on logding im ture HELF LOGIN 

»yHELP LOGIN 
LOGIN userid 


LOGIN allows vou eccess to the system 


‘userid’ is either your Last names, or 
by either 3a comma (9) or = slash (/), 
for this command, After entering sour 
for your rassword, The rassword will 


THE SYSTEM 


CL commands? 


ASSIGN BACKUF 
COBOL CONTINUE 
DEALLOCATE DNEASSIGN 

NCES NIRECTORY LnISMOUNT 
HELP HOLD 
LINK LOGIN 
MOUNT FRINT 
RENAME REQUEST 
SORT START 
UNLOCK 


LP conmmandname. Additional hele on 
able by tyring 


ier. 
by tering @ Po in resronse to a rromrt, 
tasks, and other system informations 


f some commands, tyre HELP BRIEF. 


e 


if wou have 3a valid acount. 


a UIC with the two numbers serarated 
The saquere brackets (C3) are ortional 
userid, you will be rronrted 

net echo om the your 


terminal. You can emter the rassword om the same line as the LOGIN 


command by rreceding it with @ slash» 
echoed, 


If the userid and rassword are valid» 
The losin message filer LBiCis2ILOGIN. 
terminals unless vou entered ‘userid’ 


but saur rassword will be 


vou will be lodged on the system. 
TXT? will be printed on vour 
as a WIC serarated bev = slash: in 


which case only the must recent messages will be erinted., If vou have 


8 login command file (LOGIN.CMD) in so 
executed. 


LOGIN and HELLO are identicals but LOG 
without DCL. 


ur directorys it will then be 


IN does mot work on systems 


Example 2-5 HELP Command (Sheet 1 of 3) 
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© wHELF/MCR HELLO 


To los onto this systems you must know am account or lest neme end 
the srrrorriate rassword., bos om by saying HELLO. The HELLO command 
has the following general forms; 


HELLO 
You will be rromrted for vour mame or account and raessword. 
HELLO nmame/rassword 


Where mame is your last mame,r and rassword is your account rassword, 
If the slash and rsssword are left off (they are optional), you will 
be rromrted for your rassword, 


HELLO Carersnemi/rassword 
HELLO Carre/memI/rassword 


Where grr and mem are the grour and member numbers of your account. 

The seusre brackets and rassword are ortional. If a comma serarates 

grr and memy system messades (the LB? Cirs2ILOGIN.TXT file) will be dis- 
relayed om your termingl immedistely after vou have logged in. If ae slash 
is the serarator, the LOGIN.TXT file will be disrlayved om your 

terminal until 39 4 is found in column L af the file. 


@ 2HELF coFY 
COFYC/eaualifierf€s]] infilef€s] outfile 
Qualifiers 


/BELOCKSIZE tn 
/CNOICGNTIGUOUS 
/OWN 

/REPLACE 

/TVATES dd-mmm-yey 
/SINCEi dd-mom-sy 
/SFAN_BLOCKS 
/THROUGHL { dd-mom-yy 
/SINCE 3 dd-mmm-es/ THROUGH $ dd-mmm-yy 
/TODAY 
/JEXCLULDE S$ filesrec 


The COFY command cories one or more inreut files to en outreut file. 
COFY does mot alter the ordsnization of the file. See HELF CONVERT 
for information on changing the organization of the file. 


Adbrevistion? C 
’HELF SET 
SET thing 


Tne SET command can be used to set something. The following things 
cam be set with this command? 


COAYITIME DEBUG DEFAULT DEVICE GROUPFLAGS 
LIBRARY CNOIPARTITION PRIORITY FROTECTION QUEUE 
SYSTEM TERMINAL 


Example 2-5 HELP Command (Sheet 2 of 3) 
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6 } “HELP SET TERMINAL 
SET TERMINALCittnntJ/attributefsd 


The SET TERMINAL command sets various altributes of your terminal. A 
erivilesged user can set attributes of ans other termingl-. 


The RSX-1LiM/M-FLUS Command Language Reference Manual divides the attri- 
butes into the 3 cateszories of common uses termingl seturr amd task. 
setur, 
See HELF SET TERMINAL COMMON_USE 
HELP SET TERMINAL TERMINAL_SETUP 
HELF SET TERMINAL TASK SETUP 


HELF SET TERMINAL QUALIFIERS 
HELF SET TERMINAL aquaelifiername 


@ =HELP SET TERMINAL COMMON_USE 


SET TERMINALCittnntJ/ettributels) 


The following gualifiers set terminal characteristics thet are regularly 
needed by the average terminsl user. For more information on @ rarti- 
culer characteristics tyre HELF SET TERMINAL characteristic, 


/CNOIBROADCAST 
/UCL 

/CNOJHOLI SCREEN 
/LOWERCASE 

/MCR 
/CNOJPRIVILEGED 
7CNOISERTAL 
/SFEEDY (ter) 
/UPPERCASE 
/WIDTHin 


Example 2-5 HELP Command (Sheet 3 of 3) 
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LEARNING ACTIVITIES 


1. READ the following’ sections in the 
RSX-11M/M-PLUS Command Language Manual: 


e 1.1, RSX-11M/M-PLUS and DCL: Basic 
Concepts 


e 1.2, The DCL Command Line 


e 1.3, Functional Grouping of DCL 
Commands 


e 3.5, HELP 
2. DO the following at your terminal: 
a. Issue the HELP command to see_ the 
list of topics for which there is 


information 


b. Using the SET command, change your 
current CLI to MCR 


Ce Issue the HELP command to see. what 
MCR topics are available 


d. Using the MCR SET command, change 
your current CLI back to DCL 
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FILE SPECIFICATIONS 


Files 


Information stored on the system is contained in an entity 
called a file. A file is the smallest unit of storage maintained 
by the operating system. A uSer may Store files on many different 
devices. To retrieve the files, the operating system must have a 
means of keeping track of the name of the file, to whom it belongs 
and where that file is located on a device. There is a special 
set of software that maintains the file structure called FILES-11. 
It is the software's responsibility to keep track of files by 
maintaining directories for each system _ user. Many of the 
operating system commands perform functions on a file. To 
identify the correct file, a standard format for specifying a file 
is required. 
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File Specification Command Format 

The following is an example of the complete file 
specification format. Whenever a file specification is required 
in a command, this is the format in which it is to be supplied. 
It iS not always necessary to supply information in each field. 
If a field is not supplied, the system will make some assumptions 
about the entry for that field. The second example below shows a 
"minimum required" file specification. In some instances’ this 
specification can be shortened to just the file name. 

The notes’ below describe each field of the file 
specification. We will discuss each one in detail. Study the 
notes and fix in your mind each of the Fields of the 
specification. 


A complete file specification 


DB: [305,303] EXAMPLE. MAC 3 
wee eee ee 


A minimum required file specification 


EXAMPLE.MAC 


Physical, logical or pseudo device name 
User File Directory (UFD) 

File name (@ to 9 characters) 

File name delimiter 

File type (@ to 3 characters) 


File type delimiter 


File version number 
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Devices 
Physical Device Names 


The first field in the file specification specifies the 
device where the file is stored. 


A computer system consists of various hardware components 
including: 


- Line printers 

- Disk drives 

-~ Floppy disk drives 

- Magnetic tape drives 

~ Analog to digital converters 
- Paper tape reader/punch 


To distinguish a line printer from a floppy disk drive or 
even from another line printer, the operating system must have a 
unique name with which it can associate the piece of hardware. As 
the user, you want to be able to say "I want the file that is 
Stored on the floppy disk drive rather than the one on _ the 
Magnetic tape drive." And also, "I want this file printed on the 
second line printer on the system, not the first." To do this, you 
need a format for specifying devices. When you refer to a 
specific device on the system, you can uSe the device's’ physical 
device name. 


The physical device name has the format: 


DDnn: 
Device Name Meaning Example 
Element 
Two alpha characters digi 
depicting a device. 
nn: Two numeric characters 312 


depicting the device unit 
number. The first unit 
number is @. Colon always 
required. 
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Figure 2-2 illustrates physical device names. Each device 
haS a name made up of a two character mnemonic representing the 
type of device it is, and a two digit number’ representing which 
unit of that device type it is. Table 2-4 lists the devices and 
their physical device name. In Figure 2-2, there is a device with 
the name DBl:. In Table 2-4, DB is the physical device name for 
RP@4, RP@5, and RP@6 disk drives. 


PHYSICAL DEVICE NAMES 


atten eS AY 


_PDP-11/70 


FLOPPY 

DISK 

DX1: 
myegact 


CARD READER 
CR: 


DDO: 


DBO: DB1: 


TK-7688 


Figure 2-2 Physical Device Names 
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Table 2-4 RSX-11M/M-PLUS Peripheral Devices 
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RSX-11M/M-PLUS Peripheral Devices (Cont) 
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Logical Device Names 


You may also specify a logical device name in the first field 
of the file specification. A logical device name is a generic 
name assigned to a physical device by the user. Logical device 
names provide device independence for programs and system 
operations because the association between the logical device and 
a specific physical device can easily be changed to another 
physical device. A logical device can be used in the device 
specification, but must first be associated with the actual 
physical device chosen by the user. The format of the _ logical 
device is the same as the physical device. However, the first two 


digit mnemonic is of your choosing and has the meaning that you 
associate with it. 


DDnn: 


Logical Device Meaning Example 


Two alpha characters IZ, 
depicting a device. 


Name Element 


Two numeric characters 
depicting a unit num- 
ber. Colon always 
required. 


Notes on Figure 2-3 


Figure 2-3 shows how logical device names can be used. The 
following comments are keyed to the example. 


@ The association between the physical device DB@: and _ the 
logical device LZ1: is made using the ASSIGN command. 


@ The Directory command lists the files in the user's work 
area. Specifying the logical device name of LZ1l: gets a 
directory from the physical device DB@: 


@ The logical device LZ1: is reassigned to the physical 
device DB1: 


4 | Performing the same directory command as before, you now 
get a directory from the physical device DB1: 
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@ > ASSIGN DBO: LZ1: 


LOGICAL 
DEVICE 


LZ1: 


PHYSICAL DEVICE 


© > DIR L2Z1:[305,303] 
DIRECTORY DBO:[305,303] 
16-JULY-81 10:30 


A.FTN;1 2. 10-JULY-81 14:41 
B.FTN;1 2. 9-JULY-81 8:33 
PROG.FTN;1 4. 9-JULY-81 10:05 


TOTAL OF 8./10. BLOCKS IN 3. FILES 
” 


TK-7681 


Figure 2-3 Logical Device Assignments (Sheet 1 of 2) 
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@ > ASSIGN DBI: L2Z1: 


LOGICAL 
DEVICE 


L2Z1: 


PHYSICAL DEVICE 


© > DIR L2Z1:[305,303] 
DIRECTORY DB1:[305,303] 
16-JULY-81 10:32 


VIP.FTN;2 4. 15-JULY-81 15:12 
VIP.FTN;3 5. 15-JULY-81 16:42. 
VIP.TSK;3 6. 16-JULY-81 17:01 


TOTAL OF 15./16. BLOCKS IN 3. FILES 
> 


TK-7689 


Figure 2-3 Logical Device Assignments (Sheet 2 of 2) 
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Pseudo Device Names 


You may also specify a pseudo device name in the first field 
of the file specification. Pseudo device names are a small set of 
logical device names that have special meaning to the operating 
system. They refer to devices that most users and tasks often 
use. Table 2-5 lists the set of pseudo device names. Of 
particular interest to the general user are the devices TI: and 
SY:. Wherever your terminal number is part of the required syntax 
you may substitute the pseudo device of TI:. The operating system 
then makes the association of TI: to the actual physical device 
name for you. Anyone may use TI: to represent the physical 
device name of their terminal; the operating system makes’ the 
association to the actual physical device. SY: is used in the 
Same manner. It represents the device on which your UFD is 
located. 


Not everyone uSing the system has their UFD on the same 


device. When the System Manager setS up your account, he 
establishes a UFD on a particular device. This becomes your 
default device. When you specify SY: in a command or file 


specification, the operating system makes the association to’ the 
actual physical device name. 


Table 2-5 Pseudo Device Names 
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Figure 2-4 shows the correlation between the pseudo 
(TI: and SY:) and the physical device for two users. 
user on terminal number 5, TI: equates to TT5: and SY: 
to DB@:. For the second user, TI: equates to TT31: 


equates to DB1l:. 


devices 
For the 
equates 
and SY: 


PSEUDO PHYSICAL PSEUDO PHYSICAL 
DEVICE DEVICE 


DEVICE DEVICE 


PDP-11/70 


LOCAL ASSIGNMENTS 


PSEUDO PHYSICAL 
DEVICE DEVICE 


SYSTEM ASSIGNMENTS 


Figure 2-4 Pseudo Device Names 
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User File Directories (UFDs) 


When your account is created for you, a file called a User 
File Directory (UFD) is also created. This file has the same 
number aS your UIC and will contain the names and locations of all 
the files stored on the disk structure that belong to you. At 
least one UFD exists for every user with a system account, and a 
user may have a UFD on many different devices. 


File Names 


The name given to a file generally reflects what the file is 
for. It can be from @ to 9 alphanumeric characters and is 
Separated (delimited) from the file type by a period. File names 
are given to files either by you when you create them with the 
editor, or copy them, or by programs that generate output files. 


File Types 


The file type is a 98 to 3 alphanumeric character extension of 
the file name to further qualify the type of file. It is 
separated from the version number by a ";". There are standard 
file types and each utility recognizes its own particular file 
type (Figure 2-5). Whenever you see a file with a .MAC file type 
you may assume that the contents of that file contain MACRO-11 
program Source statements. Likewise, if you see a file with a 
-FTN file type, you can assume that the contents of the file are 
FORTRAN program source statements. Table 2-6 shows the standard 
file extensions and the type of file they represent. 


Versions 
Each file has a version number that distinguishes it from 


other versions of the same file. Version numbers are octal and 
range from 1 to 77777. 
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A.FTN 


WRITE (5,999) ZERO 
999 FORMAT (1X, 15) 
CALL SUB 


SUBROUTINE SUB 


SYO: 
DBO: [305,303] 


PROG.MAC;10 


PROG.MAC 


TITLE MAC 
LIST ME 


p SBY RE2 
B: -.BLKB 10 


Cc: .BLKW80 
EVEN 


START: MOV A,RO 


-END START 


TK-7675. 


Figure 2-5 Standard File Types 
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Standard File Types 


Table 2-6 


167 


GETTING STARTED ON THE SYSTEM 


It is not necessary at all times to give complete file 
information when specifying a file. The system will make some 
assumptions about each field if you do not supply the information. 
We call this "taking the defaults." Table 2-7 lists the defaults 
the operating system takes for each field of the file 
specification. Taking the defaults and allowing the system to 
fill in the information Saves you typing, time and _ possible 
typographical errors. 


Table 2-7 File Specification Defaults 


ee ee rere sg ee 
= ——s—s—se — — 
— 


EOS 


nae 
— 


pers 


ee 


= 


ee 


ae 
ale 


: 


ee: 
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Figure 2-6 shows all the valid file Specifications for the 
latest version of the file A.FTN. The amount of information 
necessary depends upon the situation in which the specification is 
being used. If [288,200] is your UFD, then you would not need to 
specify the UFD. If you want the latest version of the file, you 
would not have to specify the version. And if you were supplying 
the file to the FORTRAN compiler, you would not have to specify 
the file type. The FORTRAN compiler searches for a file type of 
FTN by default. You will become aware of how much information you 
must supply through your use of the system. 


SY: 
DBO: [200,200] 


PROG.MAC;10 


DBO: [200,200] A.FTN;2 
SY :[200,200] A.FTN;2 
[200,200] A.FTN;2 
A.FTN;2 
A.FTN 
A. 


TK-7672 


Figure 2-6 Valid File Specifications for Latest 
A.FTN Version 
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Wildcards in the File Specification 
Wildcards 


Often, we wish to perform the same operations on many files 
with the. same name or the same file type; for instance, copying 
all our macro source files from one UFD to another, or _ perhaps, 
deleting all our listing files. To type each of these files in 
the command line would be time-consuming and we would probably 
spend more time than desired correcting our typing errors. There 
is a feature of the operating system that allows us to’ substitute 
a special character to represent the concept of "all" in the file 
Specification. Two special characters called wildcard characters 
can be used to do this. 


The character "*" is the wildcard character representing 
"all" in a variable number of character positions. The character 
"S" is the wildcard character representing "all" in a_e single 


character position. For example, we can use these characters when 
we want to represent all: 


e UFDs 

e Groups 

e Group members 
e File names 

e File types 


e File versions 
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Notes on Example 2-6 


The following comments keyed to Example 2-6 show the use of 
the wildcard characters and the results. 


A listing of the directory file for the UFD [385,383]. 
A listing of the directory file for the UFD [395,394]. 


The (*) is used in the file type field to represent all 
file types. The system interprets this as the latest 
version of all files with the name PROG and any file type, 
and displays all the files that meet this criteria. 


Using the (*) in the file name field allows us’ to. obtain 
all our macro source files without having to type all the 
file names and extensions. 


The (%) is used to indicate all possibilities in one 
character position. In this example we are asking the 
system to provide all listing files with a four character 
file name beginning with PR. 


In this example, we are looking for six character task 
file names beginning with PR. 


You may also use the (*) in the UFD. In this example we 
are looking for a listing of the directories of all the 


members of group 305. Member numbers 3@1,303, and 304 are 
listed for us. 


In this example we are asking for all the task image files 
found in the directories of all the members of group 395. 


Here we are aSking for all files that have a file name 
with an "O" as the second character of the name. The file 
name will have at least two characters in it and may have 
aS many as nine. 


Table 2-8 shows the rules for using wildcard characters. 
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Directory DK13£305»303] 


21-OCT-81 09240 


LOGIN. CMIG1 1, 04-AUG-81 08:43 
VIP.TSK#1 4, C 14-AUG-81 10348 
FAYROLL,.CBL31 2s O8-JAN-81 15331 
INFO. TXT 1 60, 07-JUL-80 12347 
LOGOUT. .CMngs i. 28-MAY-80 08349 
FROG. FTNS1 + 14-AUG-381 08335 
PROG.OBRJ31 Oo. 14-AUG-81 08236 
PROG.LST$1 0. 14-AUG-81 08236 
FROG.OBJ32 Se 14-AUG-81 08336 
FROG.LST#2 li. 14-AUG-81 08336 
FROG.FITNS2 6. 14-AUG-81 08336 
PROG. FTNS3 + 14-AUG-81 08237 
FROG. TSK$1 é. C 14-AUG-81 08337 
MACIO.MAC#5S 3. 04-AUG~81 09°14 
MACTIO.OBJ;5 1. 14-AUG-81 1060346 
MACIO.LST#1 Sy 14-AUG-81 10346 
DIRECTORY.LST31 3. 18-AUG-81 16328 
XYZ.MACHIL 3. 19-AUG-S1 09343 
XYZ.TSK31 4. C 19-AUG-81 09:43 
VIP .OBIS3 1. 19-AUG-81 09346 
VIF .MACIS 3. 19-AUG-81 09246 
VIP .OBIF4 1. 19-AUG-81 092347 
VIF .OBJ:5 1. 19-AUG-81 09347 
VIF.LST#5 Se 19-AUG-81 09247 
MACIO.MAC?7 3. i9-AUG-81 09348 
MACIO.MACS6 3. 19-AUG-81 09248 
MACIO.MAC310 3. 19-AUG-81 09349 
FRIMES.TSK#1 46, C 19-AUG-81 13357 
Totel of 193./199. blocks in 28. files 
Directory BKL:03057304) 

21-OCT-81 09341 

LOGIN. CMDs i 1. C4-AUG-81 08343 
LOGOUT.CMDSS 1, 28-MAY-80 08:49 
STARTUF .CMDS7 14. O6-JUL~-81 10383 
FRIMES.MACS 43 8. 1S-JAN-81 16315 
AIVENTURE.TSK$1 151. C O5-AUG-8i1 16329 
CLAMBAKE. TXT31 3. OS-AUG-81 16:18 
NOTICE. TXT31 14, 146-MAR-81 10334 
PRIMES.OBJ)1 2s 14-AUG-81 11309 
PRIMES.LST#1 13. 14-AUG-81 11309 
PRIMES. TSK91 44, C 14-AUG-81 11309 
FRIMES. MAF #1 3. 14-AUG-81 11309 
A.MAC;2 3. 18-AUG-81 16:30 
VIF,TSK31 4. C 19-AUG-81 13358 
FROG. TSK31 + C 18-AUG-81 16331 
Total of 26%./273. blocks in 14. files 


Example 2-6 Using Wildcards in a File Specification (Sheet 1 of 4) 
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© >nrr PROG. 


Directory DK13 030573033 
21-OCT-81 09:41 


PROG. FINS 3 6. 14-AUG-81 08:37 
PROG.OBJ52 Se 14-AUG-81 08:36 
PROG.LST#2 11, 14-AUG-81 08:36 
FROG. TSKs1 oy C 14-AUG-81 08:37 


Total of 28./28. blocks in 4. files 


2UIR *.eMAC 


Directory DKI3£305»7303) 
21-OCT-81 09340 


MACIO.MAC#10 3. 19-AUG-81 09:49 
XYZ«MACHL 3. 19-AUG-81 09343 
VIF .MACSS 3. 19-AUG-81 09346 


Total of 9./13. blocks in 3. files 


@ vnIR PRYX.LST 


Directory IKi$£305:303] 
21-OCT-81 097342 


FROG.LST#2 11. 14-AUG-81 08:36 


Totel of 11,./11. blocks in 1. file 


STIR PRALZZ. TSK 

Directory 0K1$£30523033 

21-OCT-81 09242 

PRIMES. TSK31 46. C 19-AUG-81 13257 


Total of 46./46. blocks in 1. file 


Using Wildcards in a File Specification (Sheet 2 of 
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@ >IR c305+%) 


Directory 0K1?£30523031 
21-OCT-81 09341 


LOGIN. CMI 1 1, 04-AUG-81 08343 
VIP.TSKF1 4. C 14-AUG-81 10348 
PAYROLL CBL#1 26 O8-JAN-81 15331 
INFO.TXT31 60. 07-JUL-80 12347 
LOGOUT.CMIS5 1. 28-MAY-80 08549 
PROG.FTNG 1 Ry 14-AUG-81 08°35 
PROG.OBJs1 0. 14-AUG-81 08236 
PROG.LST#1 0. 14-AUG-81 08536 
PROG.OBJ52 Se 14-AUG-81 08336 
PROG.LST#2 11. 14-AUG-81 08:36 
PROG.FING2 és 14-AUG-81 08236 
PROG.FIN: 3 &- 14-AUG-81 08237 
PROG. TSKS1 bs C 14-AUG-81 08337 
MACIO.MAC?5 3. 04-AUG-81 09314 
MACIO,OBJ#5 i. 14-AUG-81 10246 
MACTIO.LST#F1 Se 14-AUG-81 10246 
DIRECTORY.LST#i 3. 18-AUG-81 16328 
XYZ.+MACH1 3. 19-AUG-81 09243 
XYZeTSK1 4. C 19-AUG-81 09243 
VIP .OBJ#3 1. 19-AUG-81 09246 
VIF .MAC#S 3. 19-AUG-81 09346 
VIP .-OBJ54 1. 19-AUG-81 09247 
VIF OBJES 1. 19-AUG-81 09347 
VIP.LSTIS Je 19-AUG-81 09347 
MACIO.MACs7 3. 19-AUG-81 09348 
MACIO.MAC#4 3. 19-AUG-81 09°48 
MACIO.MAC?#10 3, 19-AUG-81 09249 
PRIMES.TSK?1 44, C 19-AUG-81 13257 


Total of 193./199. blocks in 28. files 


Directory DK1I?C305*304] 
21-OCT-81 09341 


LOGIN.CMD51 1. 04-AUG-81 08243 
LOGOUT.CMuDsS 1. 28-MAY-80 08°49 
STARTUF .CMD5S7 14, 06-JUL-81 10353 
PRIMES.MACS 43 8. 15-JAN-81 16315 
ADVENTURE. TSK#1 151. C OS-AUG-81 16329 
CLAMBAKE.TXT#1 Se OS-AUG-81 16318 
NOTICE.TXT#1 14. 16-MAR-81 10334 
PRIMES.OBJ+1 2s 14-AUG-81 11309 
PRIMES.LST#1 13, 14-AUG-81 11309 
PRIMES. TSK#1 4. C 14-AUG-81 11309 
PRIMES.MAF S91 3. 14-AUG-81 11309 
AMACH2 Se 18-AUG-381 16330 
VIF.TSK$1 4. C 19-AUG-81 13258 
FROG. TSK$1 &. C 18-AUG-81 16°31 


Total of 269./273, blocks in 14. files 
Directory DK130305»3013 
21-OCT-81 09341 

INFO. TXT$1 60. 17-AUG-81 14354 
Total of 60./60. blocks in 1. file 


Grand total of 522./532. blocks in 43. files in 3. directories 


Example 2-6 Using Wildcards in a File Specification (Sheet 3 of 4) 
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@ >virk £305>*1%.TSK 


Directory DKi%£305»303) 
21-OCT-81 09344 


VIF.TSK31 4. C 14-AUG-81 10348 
FROG. TSK#1 ry C 14-AUG-81 08:37 
XYZ. TSK#1 4, C 19-AUG-81 09°43 
PRIMES.TSK#1 46. C 19-AUG-81 13357 


Total of 60./60. blocks in 4. files 


Directory DKL2$C3052304) 
21-OCT-81 092344 


ADVENTURE. TSKi1 151. C OS5S-AUG-81 16:29 
PRIMES.TSK$1 46, C 14-AUG-81 11:09 
VIF.TSKs1 4. C 19-AUG-81 13:58 
PROG. TSKe1 &s C 18-AUG-81 146331 


Total of 207./207. blocks in 4+ files 


Grand totsl of 267./267. blocks in 8. files in 2. directories 


© 2nrr zox.* 


Yirectory DK1:£6305»3033 
21-OCT-81 09345 


LOGIN. CMDF1 1. 04-AUG-81 08:43 
LOGOUT.CMDS5 1. 28-MAY-80 08349 


Total of 2./2. blocks in 2. files 


Example 2-6 Using Wildcards ina File Specification (Sheet 4 of 4) 
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Table 2-8 Allowed Use of Wildcard Characters 


Soe: 
2 
pa 
ee 


2 
: 2 


LEARNING ACTIVITY 


1. READ the following sections in the 
RSX-11M/M-PLUS Command Language Manual: 


e 4.1, Files on RSX-11M/M-PLUS Systems 


e 5.1; Devices on RSX-11M/M-PLUS 
Systems 
e 5.1.2, Physical Devices, Pseudo 


Devices, LUNS and Logical Names 
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USING THE MONITOR CONSOLE ROUTINE (MCR) 
MCR 


MCR is the original command line interpreter of the 
RSX-1L1M/M-PLUS operating systems. It is the root for all DCL 
commands, and contains all the functionality of DCL and_ some 
privileged functions that cannot be accomplished in DCL. The 
format of the MCR command line is shown below. A partial list of 
MCR commands is shown in Table 2-9. Appendix B of the 


RSX-11M/M-PLUS Command Language Manual contains associated MCR 
commands for each DCL command. 
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MCR Command Format 


® 


> ALL DKO:/TERM=TT54: <RET> 


me ee ee eee” 


o0o0 90 is ] 6 J oOo 


® 


I TAN. 
>PIP_B.FIN=A.FIN/NV<RET> 
0000000 0 


Operating system prompt 

MCR command 

Command delimiter (blank or tab) 
Parameter 

Keyword 


Keyword value 

Output file specification 
Delimiter 

Input file specification 
Switch 


Command line terminator 


@eeeqoqgododgoecdsad 6 


Command line 
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Re 


BG Sete 


ee 


ee 
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Notes on Example 2-7 


The following comments are keyed to the example. 


Active command issued that shows there are three tasks 
active at your terminal. 


ABORT command issued. 

ACTIVE command issued again to see what tasks were active. 
ABORT command issued to abort the task named TT56. 

SET command issued to make DCL active at the terminal. 


SHOW USERS command issued improperly. An error message is 
returned to indicate that the command was not recognized 
by DCL. 


SHOW USERS command properly issued. 


Active Task List (ATL) command issued to display all the 
tasks that are active on this system at the time. See the 


RSX-11M/M-PLUS MCR Operations Manual for description of 


the printout. 


Installed Task List Short Form (TAS) command to display 
all tasks that are installed in the System Task Directory. 


Partition (PAR) command issued to display the partition 
configuration of memory. See the RSX-11M/M-PLUS MCR 


Operations Manual for a description of the printout. 


Device (DEV) command issued to display information about 
the magnetic tape units on the system. This display shows 
that there are two units. The first unit is privately 
allocated to TT2@:; the second iS available for use. 


Queue (QUE) command issued to list information about’ the 
print queue. There are no jobs waiting to be printed. 


Device (DEV) command issued again, only this time _ to 


display information about all the devices (both physical 
and pseudo) that are part of the system. 
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MCR>ACT 

MCReee 

«+ eMCR 

TT56 

>ABO 

>ACT 

MCReee 

++ e MCR 

TTS6 

>ABO TTS4 

ABO -- Task marked for abort 
?SET /DCL=TI? 

>»SOW USERS 

DCL -- Jllegal command 


>SET /DCL=TI: 


DCL>SHOW USERS 
HT13 €7222) 
TT43 €729374)1 
TT113 C7232] 
TT12: €72302) 
T7132 £7942) 
T7143 €721102 
TT15? £72113) 
T7163 €301*303)2 
TT172 €72366) 
TT21%3 €72372) 
TT22% £71162 
TT233 €301°3331 
T7243 £55730) 
TT253 €301744/3 
TT27% €72361) 
TTS13 €100224] 
TT533 £72337) 
TTS5S?2 €222011 
TT56? £305,303) 
TTS7:3 €721133 
>LO 

Have a Good Morning 


22-OCT-81 11303 TTS46$ lossed off QUASAR 
Sn 
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SATL 
o LIR.+«e 112050 LIRPAR 112404 00255700-00260400 FRI - 248. DFRI - 248. 

STATUS: -CHK FXD STP ~-PMD PRY NSD 

TI - COO? I0C - 0. BIO - 0. EFLG ~- 000001 000000 FS - 170000 

PC - 120370 REGS 0-6 120212 013541 177777 107646 074700 107614 120164 
RMDEMO 053120 GEN 047560 01062100-01111100 FRI - 225. DFRI - 225, 

STATUS -CHK WFR -PMD PRV MCR 

TI - TTO? IOC - 1. BIO - O- EFLG - 000020 040000 PS - 170010 

PC - 136254 REGS 0-6 000000 136333 132110 900000 136375 000243 121164 
MTAACF 051274 GEN 100544 00643600-00657400 FRI - 200. IIFRI - 200, 

STATUS: STP ACF -PMD PRY NSD 

TI - COO: IOC - O-. BIO - O- EFLG ~ 000006 040002 FS - 170001 

PC - 120650 REGS 0-46 051306 077304 051306 077244 000000 1206546 120352 
NETACF 047214 GEN 062220 01232000-01257600 FRI - 200. IDFRI ~ 200, 

STATUS: STP ACP -PMD FRY NSD 

TI - COO? IOC - O. BIO - O- EFLG - 000000 000000 FS - 170000 

PC - 120452 REGS 0-6 000004 000010 104170 000000 065504 063404 120242 
EVF.++ 060754 GEN 061140 00466700-00503100 FRI - 199. DPRI - 199, 

STATUS: STP -PMD FRY 

TI - CoO: I0C - Oo. BIO - O-. EFLG - 000001 000000 FS - 170000 

PC - 120512 REGS 0-6 127536 000000 003424 1305546 000011 1254674 120272 
MCRe++ 110160 SYSFAR 114514 00203100-00215100 FRI - 160. DFRI - 160, 

STATUS: STP -PMD PRV MCR CLI NSD CAL 

TI - TT56$ IOC - O- KIO - Of EFLG ~- 000001 040000 FS - 170000 

PC - 122436 REGS 0-6 000000 120478 122032 120432 010746 044146 120366 
+++MCRK 107614 GEN 074700 01155100-01175400 FRI - 160. [FRI - 160, 

STATUS? CKD -PMD PRV MCR NSD 

TI - TT56: IOC - O- BIO - Of EFLG - 000001 040000 FS - 170000 

PC ~ 121454 REGS 0-6 120424 121276 121706 000000 121302 000000 000742 
CA.T24 101444 GEN 077424 00657400-00664500 FRI - 150. DFRI - 150. 

STATUS! WFR -FPMD REM PRY 

TI - TT24' IOC - O- BIO - O« EFLG ~ 000000 000000 FS - 170000 

PC ~ 123266 REGS 0-6 124114 000037 122470 000001 135600 121257 121172 
FIiACF 111550 GEN 060534 01111100-01155100 FRI - 149. DFRI - 149, 

STATUS? STF ACP -PMD PRY NSD CAL 

TI - COO} IOC - O- BIO - O- EFLG - 000002 000001 FS - 170000 

PC - 135350 REGS 0-6 155272 000000 000020 1023573 060644 076224 120310 
WKFFCF 111320 GEN 046160 00526500-00572500 FRI - 149. DFRKI ~ 149, 

STATUS: -CHK STP ACP ~PMD PRY NSD : 

TI - coo? I0C - O-. BIO - O- EFLG - 000002 000001 FS - 170000 

PC - 135350 REGS 0-6 000400 155254 000000 000034 047344 100500 120310 
SYOFCP 047434 GEN 046034 00572500-00636500 PRI - 149. FRI - 149, 

STATUS: -CHK STP ACP -PMND PRY NSD 

TI - coo: 00 - 0. BIO - 0. EFLG - 000002 000001 FS - 170000 

PC - 135350 REGS 0-6 000000 074130 000032 151460 046640 074070 120310 
DRIFCF 046470 GEN 045430 00723600-00767600 FRI - 149. DPRI - 149, 

STATUS! -CHK STP ACP -PMD PRY NST 

TI - COO? I0C - 0. BIO - O- EFLG - 000002 000001 FS ~- 170000 

PC ~- 135350 REGS 0-6 034024 0746444 000032 150570 051114 0746404 120310 
DR2FCF 050460 GEN 046370 00767600-01013600 FRI - 149. DPRI - 149. 

STATUS$ -CHK ACP -PMD PRY NSD 
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© >Tas 


LIK eae 
TKTN 

RMDEMO 
MTAACP 
FiilMSG 
NETACP 
EVP eee 
MCReee 
++ e¢MCR 
oe MOU 
ee ¢ DCL 
e+ HEL 
oe eC, 
oe eCVT 
+o eDLG 
NVP woe 
oe o BYE 
FLLACP 
WKFFCF 
SYOFCP 
DRIFCr 
DB2FCP 
PMT oes 
ERRLOG 
COTeee 
oes DMO 
eeeINI 
++ UFD 
PMI. 
SHF .4+ 
oee INS 
++ +SEN 
RMHACF 
MALS$$ 
FMRS$$$ 
QMG...- 
LFO 

PRT eee 
+e BRU 
ee KKK 
eee TEC 
oe EDI 
ee+S0S 
oo EDT 
ee eMAl 
RMT soe 
oe eRVT 
EDTT1ié6 
ELTT22 
eo eATe 
NTLeeoe 
NTINIT 
+++BRO 
LPINIT 
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12.19 LIRPAR 
04-7 TKNPAR 
Vi.0S GEN 
0013 GEN 
V0O012 GEN 
Y02.00 GEN 
V0O1.00 GEN 
2.02 SYSFAR 
1.1 GEN 
2503 GEN 
00 GEN 
01.9 GEN 
4.00 GEN 
4.92 GEN 
4.02 GEN 
VO1.00 GEN 
04.0 GEN 
M0401 GEN 
M0401 GEN 
M0401 GEN 
M0401 GEN 
40401 GEN 
01.52 GEN 
V1.04 GEN 
01.01 GEN 
23.25 GEN 
22.02 GEN 
VO412 GEN 
07.2 GEN 
3.08 SYSPAR 
06 GEN 
22JUL GEN 
V0O2.00 GEN 
11RX GEN 
V0O1i.05 GEN 
1.8 GEN 
1.9 GEN 
1.2 GEN 
1.03 GEN 
GEN 
V36 GEN 
M11.04 GEN 
07.00 GEN 
02.00 GEN 
OiSEP GEN 
V02.01 GEN 
X02.19 GEN 
02.00 GEN 
02.00 GEN 
02 GEN 
V0O2.00 GEN 
V02.00 GEN 
V04 GEN 
01.03 GEN 
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248, 
248, 
225. 
200. 
200. 
200, 
199, 
140, 
160. 
160, 
160. 
150. 
150. 
150. 
150. 
150. 
150. 
149, 
149. 
149. 
149. 
149, 
148, 
148. 
145. 
140. 
140, 
140, 
130. 
10S. 
100. 
100. 
100, 
100. 
100. 
70. 
70, 
70. 
70. 
70, 
65. 
65. 
65. 
65. 
65. 
65. 
65, 
635. 
65. 
6&4, 
60. 
55, 
30. 
50, 


00002500 LBO'-01240437 FIXEL 


00010000 
00027000 
00013600 
00005500 
000254600 
00013100 
00012000 
00020300 
00037600 
000354600 
900374600 
00005100 
00052200 
00052200 
00012700 
00012500 
90044000 
00044000 
009044000 
00044000 
00024000 
00006300 
00040000 
00017000 
000144600 
90034600 
00005700 
00017600 
00012000 
00034400 
00104400 
00023300 
90132300 
00034300 
00032200 
00014100 
00001100 
00173500 
00163400 
00177100 
00123600 
00073300 
00132000 
00123700 
00027300 
00032500 
00132000 
00132000 
000460000 
00036500 
00005000 
00031000 
000146200 
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LBOt-01242244 
LBO3-01262570 
EM0?-00000325 
LRO?-01251052 
SY0$-01266761 
SY0?-01266561 
LBO%?-01244424 
LBOt-01244760 
LBO?-00117642 
SY03-01132456 
LBO?-01250645 
LBO?-01251064 
SY0!-01007774 
SY0?-01007774 
SY03-01265031 
SY0$-01264767 
LBOt-01247227 
LBOt-01262523 
EM03-000002460 
SY0%-01262313 
SY0%-012462404 
LBO?{-01246016 
LROt-01251006 
LRO?-01250736 
LBO?-01245770 
LEO?-01246445 
LBO?-01246615 
LBO?-01250210 
LBO!-01250203 
LBO?-01243744 
LBOt-00662645 
SY0!-01265073 
SY03-00663342 
5Y03-00660507 
LBO?-01252004 
LRO?-01252136 
LBO?-01251443 
LRO?-01256414 
DK22-00010412 
EM0?-00001215 
£M0}-00001371 
EM0!-00001547 
LBO?-01254476 
SY0!-00555723 
$Y0$-012466505 
SY0?-00663556 
LBO?-01254474 
LROt-01254476 
LBO?-01246107 
SY0?-01265603 
$Y03-01265347 
LEO?-01250552 
LBO}-01250260 
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+ @eQUE 1.10 GEN 90. 00025200 LBO?-01252041 
eoePRI 1.10 GEN 50. 00025200 LBO?-01252041 
eeePIP M1343 GEN 90. 00132300 EM03-00000443 
e+eMAC M1200 GEN 50. 00110100 ENO3-00000557 
¢oeTKB 440.00 GEN 50+ 00102400 EM03-00002310 
eoeL BR 06,00 GEN 50. 00154400 EMO:~-00001103 
CRF.+- VO1 GEN 30+ 00116600 EMO$~-00001165 
oo eMUN V36 GEN 50. 00177100 ENO:-00001215 
eeeCMF VOI09 GEN 50. 00151300 EMO3-00001341 
e+eRNO M0101 GEN 590+ 00061600 EMO%-00001443 
ooe¢SLP 11.03 GEN 50, 00027400 EMO?-00001515 
eoeSRD 4.1F GEN JO, 90043500 EMNO+-00001750 
o+eBCK 0002CM GEN 50. 00065600 SY03-00065660 
+++ DOC O6DEC GEN 30+ 000614600 SY0?3-00063564 
+e¢eDTR VO1.10 GEN 50. 00175000 SY03-00063652 
MAL... 3OOCT GEN 30+ 00057700 SY03-00553461 
NICE.+ ¥V02.00 GEN 50. 00026600 SY03-01266362 
+oeNCP VOL.00 GEN 50, 00037100 SY0$-012646061 
FAL.+. V02.01 GEN 90. 00075200 SY0!-01267327 
eo+NFT V02.00 GEN 30. 00035400 SY0%$-01267224 
+CHTS. VO2,.00 GEN 50+. 00002000 SY0:-01235557 
TCLoee VO2.00 GEN 90. 00002400 SY0'-01265126 
oo /NTD VO1.00 GEN 90. 00021200 SY03-01265005 
NTD.++ VO1L,00 GEN 50, 00011700 SY0?-01266544 
ee e+RMT VO2.00 GEN 50+ 00002100 SY03-01235551 
eo ePLX M15 GEN 30. 900037700 LBO$-01253617 
ee +LOA 03.3 GEN 990+ 00033100 LBO:-01244354 
oo UNL 3.0 GEN 50. 00025100 LBO?}-01245146 
oo tF4F V3.0 GEN 50+ 00122600 SY0+-00107722 
++ Q“WE KHTUE GEN 30. 00040000 SY0;}-00144024 
e+e TMC S3OSEF GEN 50+ 00043700 SY03-01106661 
EX1 210CT GEN 390. 00055700 SY0'$-001325464 
EX2 210CT GEN 50. 00055700 SY0?-00132564 
EXST 210CT GEN 990+ 90055700 SY0+-00132564 
EX3 210CT GEN 90. 00055700 SY03-001325464 
HT1 220CT GEN 99+ 00107400 SY03-00425313 
TT12 18JAN GEN 90+ 00112600 SY03-00546303 
TT23 Mi332 GEN 90. 001546400 SY03-00134222 
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@® >rar 
CEXPAR 
TTPAR 
EXCOM1 
EXCOM2 
SYSFAR 
TKNPAR 
DRVPAR 


114734 
114670 
114624 
114560 
114514 
114450 
114404 
114340 
114240 
114140 
114040 
113740 
113640 
113540 
113440 
113340 
113240 
113104 
112450 
112404 
112340 
112274 
112230 
112164 
045174 
061140 
046100 
046160 
046034 
100544 
075740 
045430 
046370 
046270 
044770 
0475690 
060534 
062434 
062220 
073370 
070750 
045240 
071730 
076224 
074554 
076760 
071040 
075650 
100610 
062634 
053244 
062264 
061074 
045034 


LDRFAR 
BASIC2 
FCSRES 
TSTFAR 
GEN 


NT.PCL 
NT. NSF 
NT. AUX 
POOL.. 
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00115000 
00120000 
00160000 
00174700 
00203100 
00215100 
00225100 
00225100 
00227200 
00230400 
00233500 
00236500 
00237600 
00240700 
00242300 
00245000 
00247600 
00251100 
00255400 
00255700 
00260400 
00320400 
00360400 
00460400 
00460400 
00466700 
00507200 
005246500 
00572500 
00643600 
00666000 
00723600 
00767600 
010134600 
01046000 
01062100 
01111100 
01155100 
01232000 
01300100 
01362200 
015146200 
01650500 
01760100 
02112100 
02172100 
02324400 
02402300 
02777700 
03671600 
03675300 
03713300 
03714400 
03776300 


00003000 
00040000 
00014700 
00006200 
00012000 
00010000 
00030600 
00002100 
00001200 
00003100 
00003000 
00001000 
00001100 
00001400 
00002500 
00002400 
00001300 
00004300 
00000300 
00002500 
00040000 
00040000 
00100000 
03317400 
00006300 
00014200 
00017000 
00044000 
00044000 
00013600 
00023300 
00044000 
00024000 
00032200 
00014100 
00027000 
00044000 
00020300 
00025600 
00055700 
00132000 
00132300 
00107400 
00132000 
00060000 
00132000 
00055700 
00112600 
00153100 
00003500 
00016000 
00001100 
00061700 
00001500 
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MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
SUB 
SUB 
SUB 
SUR 
SUB 
SUR 
SUE 


SUR 
SUB 
SUB 
SUB 
SUB 
SUB 
SUB 
SUR 
SUB 
SUE 
SUB 
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COM 

TASK 

COM 

COM 

TASK 

TASK 

SYS 

DRIVER -DB$ 
DRIVER -LK$ 
DRIVER -DM$ 


DRIVER -DRE 
DRIVER -EM? 
DRIVER -DT3 
DRIVER ~-DX3 
DRIVER -DL¢ 


DRIVER ~-DEs 
DRIVER -LF3 
DRIVER -MM3 
DRIVER -CO} 
TASK 

COM 

COM 

TASK 

SYS 

CPMTs ++) 
CEVF...) 
(COTs+.) 
CWRFFCF) 
(SYOFCF) 
(MTAACF) 
CRMHACF ) 
(CIBLFCF)> 
(QE2FCF) 
(QMG.4 6) 
(LFO ) 
CRMDEMO) 
(FiilACF) 
(e+ eMCR) 
(NETACF) 
(EXST > 
(ee ELT) 
Coe e PIP) 
CHT1 ) 
(ERTT22) 
Cee e AT.) 
CEBTT1I4> 
(EX2 ) 
(TT12 > 
Cees TKB) 
DYNAMIC 

LY NAMIC 
DYNAMIC 
DYNAMIC 
DRIVER -HT3 
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=SET TERMINAL “MCE 

“TIME 

20811256 06-JAN-82 

‘OEY MMi 

MMO? TT20% - Frivate Loaded 
MMi: Loaded 


(12) *QUE/LI 
*k PRINT QUEUES *x 
FRINT => LEO 
LFO => LEO 


® -nev 
HTO3 Offline Loaded 
HT1: Offline Loaded 
HT2? Offline Loaded 
HTS? Offline Loader 
LFO’ Loaded 
THO? Loaded Tyre=RFOS 
DR13 Public Mounted Loaded Lebel=1LIMDEV Tyre=RF06 
DBR23 Public Mounted Loaded Laebel=RSXUTIL Tyre=RFO46 
I00% Offline Loaded 
UO13 Offline Loaded 
[KO? Loaded 
UKL: Loaded 
UK23 Loaded 
URS! Loaded 
MLO? TT20% - Frivate Loaded Tyre=RLO1L 
DLL: Loaded fure=RLO1 
TIihL2: Loaded Tyre=RKLO2 
IMO: Offline Loaded Tyre=RKO6 
[M1 Loaded Tyre=RKO6 
[IiM23 Loaded Tyre=kK0?7 
UiRO: Public Mounted Loaded Lebel=QUASARUSERS Tyre=RFO7 
[DR1$ Loaded Tyre=RM03° 
NS03 Offline Unloaded Tyre=kS04 
USi: Offline Unloaded Tyre=kS04 
UrTO: Loaded 
DT1L: Loaded 
IiX03 Loaded 
[X13 Loaded 
EMO’ Offline Unloaded Tyre=ML1II 
MMO? TT20: - Private Loased 
MMi? Loaded 
C00: Loaded 
NSO? Fublic Mounted Loaded 
TTO0?3 Loaded 
TT1: Loaded 
TT2? Loaded 
TT3% Loaded 
TT43 Loaded 
TT33 Loaded 


NLO? 
TIO; 
CLO; LFO; 
LOS DROS 


SYO; [KO$ 
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PRIVILEGED COMMANDS 


There are commands that could possibly harm the work of other 
users and even affect system performance. These are privileged 
commands. To execute these commands you must either have an 
account with a group number of 1@ or less (a system user, also 
called a privileged user) or have had your terminal set to 
privileged by a system _ user. Table 2-18 lists some of the 
commands that require having privileges to perform them. Tf at 
any time you need to perform a privileged command and do not have 


a privileged account, see your system manager or a_e system 
programmer for help. 


Table 2-18 Partial List of Privileged Commands | 


Rees Ee A oe io 
ks ‘2 Oe EG SS be 

OG ee ean 

~ 


ae 


4 
oe 
oo, 
oe ‘ 


os 
Ps 
ee 


ue 


ia Me a 
oS s ee 2 
T 


ic oS 
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INTERPRETING ERROR MESSAGES 

Error messages are returned when you have improperly supplied 
information in a command line, or the operating system wants to 
inform you that what you have requested is not available. 


The error message format is shown below. Table 2-11 shows 
some common error messages. 


Error Message Format 


>MCR--NOT LOGGED IN 


Nu 
9 2 


> DCL-- ILLEGAL COMMAND 
° ° 


@ Task from which the error was generated 


@ Message describing the error condition 
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Table 2-11 Some Common Error Messages 


Se 


so 
oe 


Pe 
o 
Soe, 
EP 


ee 
Be ease 
— . 
ee Se 
Sees 
oo 


LEARNING ACTIVITIES 


READ Chapter 1, Introduction to MCR, in 
the RSX-11M/M-PLUS MCR Operations Manual. 


READ Appendix A: Common Error Messages, 
in the RSX-11M/M-PLUS Command Language 
Manual. 


DO the Lab Exercises for this module. 
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CREATING AND MODIFYING FILES 


INTRODUCTION 


Users spend considerable time creating and modifying text 
files. Text files are files consisting of ASCII characters - 
either straight text (e.g., a letter or a manual) or Source text 
(e.g.-, a MACRO or FORTRAN program). There are a number of DEC 
editors available for this purpose. 


In this module, you will learn to use one of the more 
powerful DEC editors, EDT. In another module, you will learn some 
additional techniques available with EDT. The two modules 
together cover a subset of the full range of EDT facilities needed 
for most file editing. After you become adept at using this 
editor, read over the resources below to find some short cuts and 
even more sophisticated techniques. 


OBJECTIVES 


l. Invoke the EDT editor, execute editor commands, and exit 
from the editor. 


2. Use the editor to perform the following functions: 
a. Create text files. 


b. Change existing text files using line-oriented and 
character-oriented editing techniques. 


c., Produce output files containing the results of an 
editing session. 


RESOURCES 


EDT Editor Manual 


133 


CREATING AND MODIFYING FILES 


OVERVIEW 


There are many devices used to input data into the computer. 
Everything from Magnetic tape to pressure and temperature 
measuring devices can send information to the CPU, memory or disk. 
However, these are mechanical devices that do not allow for human 
interaction. Not long ago punched cards were the most popular 
method used for inputting data. Today, we consider that method 
rather archaic and use instead a faster, more interactive device, 
the terminal. 


Purpose of an Editor 


A text editor is an interactive task used in conjunction with 
a terminal to create and edit ASCII text files that are stored on 
disk. It is used to create: 


- documentation files 
- memo files 

- program source files 
- program data files 


Figure 3-1 shows the process of creating a text file using 
EDT, DIGITAL's standard editor. A user, sitting at a terminal, 
will invoke the editor and after supplying the proper commands for 
specifying a new file name and indicating the input mode, will 
start inputting the lines of desired text. The editor program 
collects the string of characters (exactly as typed) into a buffer 
until the user terminates the input mode. It is not until the 
user instructs the editor to save the buffer that a file is 
written to disk to preserve the editing session. The file written 
to disk is in ASCII format; no translation has been performed on 
its contents. The contents of the file may be viewed at the 
terminal with the aid of a utility task. 


Figure 3-2 shows the process of editing a text file that 
already exists. When the name of an existing file is supplied to 
the editor, a copy of that file is read into the editor's main 
buffer. The editor then waits for commands to change the copy of 
the file that exists in this buffer. Once again, those changes 
are not reflected in a disk file until the user instructs the 
editor to save the contents of the buffer. When such a command is 
issued, a new copy (version) of the file is written to disk. 
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9ET 


MEMORY SY: 
[305,303] 


EXIT 
COMMAND 


> EDIT/EDT NEW.TXT EDT BUFFER 
INPUT FILE DOES NOT EXIST 
[EOB] 

¥ | Fe ee es 
THIS IS A LINE 
THIS IS ANOTHER 

IN Z 

* EXIT 


TK-7683 


Figure 3-1 Creating a Text File 


Sd1Id ONIAAIGOW AGNV ONILVaYO 


LET 


MEMORY SY: 


[305,303] 
1) COPY OF 


OLD FILE 
READ IN 


© ew cory 


> EDIT/EDT NEW TXT WRITTEN OUT 


* % WH 
1 THIS IS A LINE 
2 THIS IS ANOTHER 
* (DERE TLE? 
EXIT 


IN EDITING AN EXISTING FILE: 


A COPY OF THE EXISTING FILE 
IS READ INTO THE BUFFER 
FROM DISK. 

CHANGES ARE RECORDED IN 
THE BUFFER. 

A NEW FILE IS WRITTEN OUT 
TO DISK WHEN INSTRUCTED BY 
THE USER. 

ORIGINAL DISK FILE IS 

LEFT UNTOUCHED. 


TK-7684 


Figure 3-2 Modifying Existing Text Files 


Sad1IId ONIATIGOW ANY ONILWSYO 
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EDT Editor Features 


EDT is a text editor that is available on many of DIGITAL's 
operating systems. It offers many features that make text editing 
easier and more efficient. These features are listed below. 


DIGITAL's standard editor 


Line mode/character mode - EDT performs editing operations 
on a line-by-line or character-by-character basis. In 
line mode the cursor position is always at the left-most 
Side of the display. In character mode the curSor moves 
freely from left to right and up and down on the display. 


English-like commands 
Help facility 


File protection by journaling - While performing your 
editing operations, EDT is recording all the keystrokes in 
a file. If for any reason the editing session abnormally 
terminates, this file is available for processing to 
recover what has been edited. 


Startup command files - The editor reads a special file 
containing editing commands that create a _ processing 
environment tailored to the user's preferred methods of 
editing. 


Redefine key functions 


Multiple buffers and file access - A buffer to an _ editor 
user is like a sheet of paper to a writer. A writer might 
want a long sheet of paper to write his story and another 
sheet on which to make notes. More than one buffer can be 
created in EDT. These alternate buffers can be used _ to 
Store things like notes, routines, or editing commands. 
Other files may be read into a buffer and searched without 
having to exit from the editor. EDT also provides for 
reading and writing other files while remaining in an 
editing session. 


Automatic backup - The editor always creates a new file 
for the user leaving the previous version intact. 


Macro capability - A powerful feature of the editor is the 
ability to create new commands that are made up of a 
series of editing commands. The new command is’ issued 
just like a standard editor command. This expands the 
functionality of the editor to whatever the user is able 
to create. 
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CREATING A TEXT FILE 


Example 3-1 shows the procedure for creating a text file. 


> EQLIT/EUT NEW. TXT 
Ineut file does not exist 


CEORJ 
@ x1 
TELL @ MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
ANI HELL BELIEVE YOU. TELL HIM A BENCH HAS WET FAINT 
ON IT AND HE’LL HAVE TO TOUCH IT TO BE SURE. 
UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY» AND OTHER VAININRIABLES THE 
ORGANISM WILL DO AS IT DARN WELL FLEASES, 
ANY GIVEN PROGRAM: WHEN RUNNING IS OBSOLETE. 
THE NEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 
ge 
LEOBI 
© kexrt 


@ URO:C305+303INEW.TXTH1 11 lines 
Example 3-1 Creating a Text File 


Notes on Example 3-1 
The following comments are keyed to the example. 


@ DCL command EDIT used to invoke an editor. /EDT qualifier 
tells which editor to use. The file name NEW.TXT is 
supplied. EDT responds by indicating that the file does 
not exist and displays the "end of buffer" ([EOB]) symbol 
to indicate an empty buffer. 


@® (*) is EDT's prompt indicating that it is ready to accept 
commands. EDT, by default, begins in line mode. In line 
mode the cursor always remains at the left-most position 
of the display and only moves forward and backward 
line-by- line in the file. All operations are performed 
on a complete line. To enter lines of text issue the 
I({NSERT] command. The cursor moveS over and waits’ for 
your input. Although not displayed here, EDT assigns line 
numbers to the lines of text that are entered. This input 
mode is terminated by typing <CTRL/Z>. | 


(3) EDT prompts (*) to indicate that it is again ready to 


accept commands. The EXIT command is issued to save the 
contents of the main buffer into a disk file. 
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@ =EDT responds to indicate completion of the exit function 
by displaying the complete file specification, including 
the version number and number of lines saved in the file. 
Version numbers are octal numbers, beginning at 1 for a 
new file and increasing by 1 for every edit of that file. 


5) EDT returns control to the system, and the operating 


system displays its prompt indicating readiness to accept 
another command. 


EDITING AN EXISTING FILE 


Example 3-2 shows the process of editing an existing file. 


r:) sEDIT/ELT NEW. TXT 


° t TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
KAWH 
1 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
2 AND HE’LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
3 ON IT ANT HE’LL HAVE TO TOUCH IT TO BE SURE. 
4 
a UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF FRESSURE 
é TEMPERATURE, VOLUMEs HUMIDITY» AND OTHER VARIABLES THE 
? ORGANISM WILL [0 AS IT DARN WELL FLEASES. 
8 ANY GIVEN FROGRAM: WHEN RUNNING IS OBSOLETE. 
9 
10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY FPROFGRTIONAL 
11 TO THE LEVEL OF MANAGEMENT. 
CEORI 
KXEXIT 


@ UROIC305,+303INEW.TXTF2 11 lines 


Example 3-2 Editing an Existing File 


Notes on Example 3-2 
The numbered comments are keyed to the example. 
@ The editor is invoked using the DCL command and qualifier 
specifying EDT. A file name is supplied referencing an 


existing file. The contents of that file are read into 
the EDT buffer. 
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6 EDT prompts and a command is issued to display the 
complete buffer ending with [EOB] symbol. Line numbers 
are displayed which reference a particular line or range 
of lines in EDT commands. They are present only during 
the terminal session, and not saved in the output file. 
The exit command is issued to save another version of the 
file. 


3) EDT responds that the Save operation is complete, and 
shows the new file specification and version number. A 
directory taken on NEW.TXT produces the following: 


“DIR NEW. TXT 
Directory DRO3L3057303] 
6-JAN-82 22339 


NEW.TXT31 ‘ 15-TEC-81 16:51 
NEW. TXT#2 2 06-JAN-82 22539 


Jb 


t 


Totel of 4.77. blocks in 2. files 


THE HELP FACILITY 


Just as you have a HELP function at the operating system 
level, EDT also has a HELP command to provide information about 
the commands available to you in line mode. Issuing the HELP 
command gives you a list of all the commands for which information 
is provided. To obtain help for a command or a subtopic of a 
command , type HELP along with the command name and subtopic as 
shown in the second and third examples below. Example 3-3 shows 
how to access the HELP command. 


Command Format 


* HELP<RET> 
* HELP COPY<RET> 
* HELP COPY/QUERY<RET> 
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2 EDIT/EDT NEW. TXT 
1 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
* HELF 
i HELF 
You can get hele on &@ toric by turing 


HELF toric subtoric subsubtoricess 
A toric can have one of the following forms} 


1. Am alehanumeric string (eed. & command mame, ortions eter? 
2, The match~-3all or wild card symbol (xk) 


Exameles 3 HELP SUBSTITUTE NEXT 
HELF CHANGE SUBCOMMANT 
HELP CH 
If a@ toric is abbreviated, the text for all tories which match the 
aboreviation is disrleved,. 


Additional information svailsble: 


KEYPAD CLEAR CHANGE COPY NEF INE 
DELETE EXIT FILL FIND INCLUDE 
INSERT JGURNAL MOVE PRINT QUIT 
REPLACE RESEQUENCE RANGE SET SHOW 
SUBSTITUTE TABS TYFE WRITE 


XHELF COFY 

The COPY (abbreviation? CO) command cories text from one location to 
another within 2a buffer or between ouffers. When text is corieds 
the source text remains intact. 


Formats COFY Cranse-1] TO Crange-2] C/QUERY] C/DUFLICATEind 


The lines srecified by range-1 sre coried in front of the first line 
specified hy rande-2. Either range defauits to the current line. 


If the destination is mot the current vuffery, fut tie mama of the 
receiving buffer immediately after TO (=buffer). Give the 

full mame of the buffer. To cory text from en external filer see 
INCLUDE, 


Additional information availeble: 


/GUPLICATE QUERY 
KHELF COFY /QUERY 
Format; /QUERY 


When you use the /QUERY (abbreviation? -/@) auslifiers ENT feromets voy 
with a ’?’ to verify each line to be curried, 


Resronses are} 


Yess cory this line 

Nor do mot cory this line 

Quits do not cory any of the rest of the lines 
Ally cory all the rest of the lines 


POoz< 


K EXIT 
UROSCSOS*s303INEW, TXT§S 11 lines 


“ 


Example 3-3 HELP Command 
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EDITING COMMANDS USING LINE MODE 


Once you have entered some text into the EDT buffer, you can 
issue commands that alter the contents of the buffer. Such 
commands allow you to copy lines, move them, delete them or change 
the text within the line. Table 3-1 lists some of the commands 


available in line mode. 


Table 3-1 Line Mode Commands 


IEEE ey ee 
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COMMAND MODE COMMANDS 
Displaying Lines 


The TYPE command is used to display lines of text at _ the 
terminal. It takes aS a parameter a range of line numbers to be 
displayed. This is the default command for the editor, so if you 
only supply a range of lines, EDT assumes that you mean the TYPE 
command. This is generally the way the type command is’ used. 
Table 3-2 shows acceptable range specifications. A convenient 
feature in specifying a range of lines is the ability to mix 
numerics and mnemonics. For example, the following is an 
acceptable range for specifying lines 5 through the end of the 
file: 5:E. 


The TYPE command also changes the current line pointer. If 
you are at line 1 and type line 19, when it finishes typing, your 
current line is line 18. If you type 2:5, when it finishes 


typing, your current line is line 2. Example 3-4 shows how to use 
the TYPE command. 


Command Format 


*[TYPE] 5:10<RET> 
1 ] o 3 


@ EDT command name to type lines on the terminal; everything 
within brackets is optional. 


@ Range of lines to be typed in the general form: 


FIRSTLINE: LASTLINE. 


3) Command line terminator. 
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Table 3-2 Range Specifications 
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KT YF 


oC GN OB CM 


Oo ch S Oh 


% 
x 
= 
x= 


SON & LID OI Pe 


x4 


XEXIT 


er 4 
he 
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NEW. TXT 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
UNIIER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF FRESSURE 
TEMPERATUREs VOLUME» HUMIDITY» AND QTHER VARIABLES THE 
ORGANISM WILL 0O AS IT DARN WELL PLEASES. 

ANY GIVEN FROGRAMN» WHEN RUNNING IS OBSOLETE. 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY FROFORTIONAL 


AND HE’LL BELIEVE YOU. TELL HIM A BENCH HAS WET FAINT 
ON IT AND HE’LL HAVE TO TOUCH IT TO BE SURE. 


UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF FRESSURE 
TEMPERATURE, VOLUME» HUMIDITY» AND OTHER VARIABLES THE 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

AND HE’LL BELIEVE YOU. TELL HIM A BENCH HAS WET FAINT 

ON IT AND HE’LL HAVE TQ TOUCH IT TO BE SURE. 

UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF PRESSURE 
TEMPERATUREs VOLUME» HUMIDITY» AND QTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL FLEASES. 

ANY GIVEN PROGRAM» WHEN RUNNING IS OBSOLETE. 

THE DEGREE OF TECHNICAL COMFETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 

TEMPERATURE» VOLUME>s HUMIDITY» ANI OTHER VARIABLES THE 

AND HE’LL BELIEVE YOU. TELL HIM A BENCH HAS WET FAINT 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY FROFORTIOQNAL 
THE DEGREE OF TECHNICAL COMFETENCE IS INVERSELY PROFORTIONAL 
UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS QF PRESSURE 
ORGANISM WILL DO AS IT DARN WELL FLEASES. 

ORGANISM WILL DO AS IT DARN WELL PLEASES. 

UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF FRESSURE 


TEMFERATUREs VOLUME» HUMIDITY: AND OTHER VARIABLES THE 


DROSCSOSy3O3INEW.TXT#4 11 lines 


Example 3-4 TYPE Command 
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Inserting Lines 


When you are creating a new file or adding to an existing 
file, the INSERT command is used to add lines of text. INSERT 
takes as a qualifier the range of where the text is to be added. 
The editor inserts the added text before the specified line 
number. When adding multiple lines after INSERT is entered, the 
Cursor moves over two tab stops and waits for the lines of text to 
be typed. To terminate the input process, a <CTRL/Z> must be 
typed. When the (*) prompt is displayed, EDT is ready to accept 
another command. 

When inputting a single line of text, the line of text is 
added to the command line (see the second example below) when the 
insert command is issued. You need not type <CTRL/Z>. After 
inserting the text line, EDT prompts for more commands. It does 


not wait for further input lines. Example 3-5 showS how to use 
the INSERT command. 


Command Format 


*INSERT] 10<RET> 


ee at wee” 
0 2 ° 


*| 10;PUT IN THIS LINE<RET> 


0 00 © °o 


EDT command to insert text 


Line number range 


Line of text to be entered 


Command line terminator 


 ) 
°o 
© ovelimiter 
 ) 
°o 
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*. 


3 
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KH OOS 
+ 
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A MEETING IS AN EVENT AT WHICH THE MINUTES ARE KEFT 

AND THE HOURS ARE LOST. 

“Z 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY FROFORTIONAL 


ANY GIVEN FROGRAM>s WHEN RUNNING IS OBSOLETE. 


& MEETING IS AN EVENT AT WHICH THE MINUTES ARE KEFT 

AND THE HOURS ARE LOST. 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY FPROFORTIONAL 
TO THE LEVEL OF MANAGEMENT. 

THAT ENDS. 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY FPROFORTIONAL 


ANY GIVEN FROGRAM» WHEN RUNNING IS QESOLETE. 


A MEETING IS AN EVENT AT WHICH THE MINUTES ARE KEFT 

AND THE HOURS ARE LOST. 

ALL’S WELL THAT ENDS, 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY FROFORTIONAL 
TO THE LEVEL OF MANAGEMENT. 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE’LL BELIEVE YOU. TELL HIM A BENCH HAS WET FAINT 
ON IT AND HE’LL HAVE TO TOUCH IT TO BE SURE. 


UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF PRESSURE 
TEMPERATUREs VOLUMEs HUMIDITY» AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL FLEASES. 

ANY GIVEN FROGRAM,s WHEN RUNNING IS OBSOLETE. 


A MEETING IS AN EVENT AT WHICH THE MINUTES ARE KEFT 

AND THE HOURS ARE LOST. 

ALL’S WELL THAT ENIIS. 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY FROFORTIONAL. 
TO THE LEVEL OF MANAGEMENT. 


Example 3-5 INSERT Command 
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READ 
Reference Manual: 


DO 


LEARNING ACTIVITIES 


the following in the EDT 


Chapter 1, Introduction to EDT 


Chapter 2, Sample Editing Sessions - 
Getting Started and Line Editing 
Sections 


Chapter 6, Line Numbers, Text Buffers 
and Ranges 


Chapter 7, Line Editing - Insert 
command 


the following at your terminal: 


Create a file with the name TEST.TXT. 
Insert the line "The quick brown fox 
jumped over the lazy dog's’ back." 
three times. 


Exit from the editor, saving’ the 
lines ina file. 


Reedit the file and issue the HELP 
command. 


Obtain HELP on TYPE. 


Display the lines in your file by 
issuing the following command: 


TYPE W 


The line numbers will appear with the 
lines of text. 


Exit from the editor. 
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Deleting Lines 


To remove lines from the text buffer use the DELETE command. 
The QUERY qualifier enables the user to selectively delete lines 
within a range of lines. When this form of the command is’ used, 
the editor displays the first line in the range of lines and then 
waits for the user to respond with "Y" for yes (meaning to delete 
the line), "N" for no, "A" for all (delete all remaining lines in 
the range) or "Q" for quit (do not delete any of the remaining 
lines in the range). Example 3-6 shows how to use the DELETE 
. command. 


Command Format 


*D[ELETE] 10:20<RET> 


wee ee ee” 
 ] 2 ) A) 


*D[ELETE] 10:20/QUERY <RET> 


© 2 ° o 


EDT command to delete lines 
Range specification 


Command qualifier 


Command line terminator 
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x 


9 
Ra 


xr 8 


1 line deleted 


9 


KO 9,139.4 
3 lines deleted 


10 
*AWH 


ONO C1 D> Gs 


?N 


deleted 
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AND HE‘’LL BELIEVE YOU. TELL HIM A BENCH HAS WET FAINT 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROFORTIONAL 
TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

AND HE’LL BELTEVE YOU. TELL HIM A BENCH HAS WET FAINT 

ON IT AND HE’LL HAVE TO TOUCH IT TO BE SURE. 

UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF FRESSURE 
TEMPERATUREs VOLUMEs HUMIDITY: AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 


THE ATTENTION SFAN OF & COMPUTER IS ONLY AS LONG AS ITS ELECTRIC 


CORI. 


THE ATTENTION SPAN OF A COMPUTER IS ONLY AS LONG AS ITS ELECTRIC 


CORD. 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY FROFORTIONAL 

TO THE LEVEL OF MANAGEMENT. 

THE ATTENTION SPAN OF A COMPUTER IS ONLY AS LONG AS ITS ELECTRIC 
CORD. . , 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY FROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 


Example 3-6 DELETE Command 
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Copying Lines 


To copy a range of lines to another section of the file, use 
the COPY command. The original lines remain intact and a 
duplicate set of lines is inserted at the new location. The copy 
command alsSo allows you to selectively copy lines within a range 
of lines (aS Shown in the second command example below) and _ also 
to make more than one copy of the lines (as shown in the third 
command example). Example 3-7 shows how to use the COPY command. 


Command Format 


*CO[PY] 1:4 TO E <RET> 
*CO[PY] 1:4 TO 13/Q<RET> 
*CO[PY] 1:4 TO 13/DUPLICATE:2<RET> 


#00 124 TOE 
4 lines carded 
AWE 

1 TELL A MAN THERE ARE 300 BILLION STARS TN THE UNIVERSE 
ANT HECLL BELTEVE YOU. TELL HIM A BENCH HAS WET FAINT 
ON IT AND HECLE HAVE TQ TOUCH TY TO BE SURE. 


el. ALLS WELL THAT ENTS. 


a UNDER THE MOST RIGOROUSLY CONTROLLED CONTTIONS OF PRESSURE 

& TEMPERATURE» YOLUME» HUMTUITY» AND OTHER VARTABLES THE 

? ORGANISM WILL TO AS IT GARN WELL FLEASES. 

} ANY GIVEN FROGRAMs WHEN RUNNING ITS OBSOLETE. 

190 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY FROFORTIONAL 
aa TO THE LEVEL OF MANAGEMENT. 

12 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNTVERSE 

13 AND HE-‘LL BELTEVE YOU. TELL HIM A BENCH HAS WET FAINT 

14 ON IT AND HE CLL HAVE TO TOUCH TT TO BE SURE. 


NROIE SOS, SOSINEW. TXTIS 17 lines 


Example 3-7 COPY Command 
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Moving Lines 


To change the physical location of a line or group of lines, 
use the MOVE command. This command moves the lines defined by the 
first range specified, to the location preceding’ the line 
specified by the second range. In sheet one of Example 3-8, the 
MOVE command is issued to move lines 1 through 4 to line 28. 
Notice that when the complete buffer is displayed, lines 1 through 
4 no longer precede line 5 and are now positioned before line 2@. 
They now have line numbers 19.1 through 19.4. 


Command Format 


‘M[OVE] 1:4 TO 20<RET> 
‘M[OVE] 1:6 TO 21/Q<RET> 
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KXwh 


CWON A UD Ne 


2i 
CEOBI 
Km 134 to 20 
4 lines moved 


“ kAwh 
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TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 


AND HE’LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE’LL HAVE TO TOUCH IT TO BE SURE, 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE» VOLUME» HUMIDITY» AND OTHER VARIABLES THE ~ 
ORGANISM WILL BO AS IT DARN WELL PLEASES, 


ANY GIVEN PROGRAM» WHEN RUNNING IS OBSOLETE. 


THE ATTENTION SPAN OF A COMPUTER IS. ONLY AS 
LONG AS ITS ELECTRICAL CORD. 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE? VOLUME>s HUMIDITY» AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES, 


ANY GIVEN PROGRAM» WHEN RUNNING IS OBSOLETE. 


THE ATTENTION SPAN OF A COMPUTER IS ONLY AS | 
LONG AS ITS ELECTRICAL CORD. 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY FROFORTIOGNAL 
TO THE LEVEL OF MANAGEMENT. 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS FASSED 
FINAL INSPECTION. 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE’LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE’LL HAVE TO TOUCH IT TO BE SURE. 


Example 3-8 MOVE Command (Sheet 1 of 2) 
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KZwh 


SONA UD Ihe 


CEOB] 


Km 
ty 
?y 
Puy 


tn 


en 


136 to 
1 


2 
3 
4 


ke) 


6 


2i /a 


3 lines moved 
kKAwh 
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TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE’LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE‘LL HAVE TO TOUCH IT TO BE SURE. 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATUREs VOLUME, HUMIDITY» AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 


ANY GIVEN FROGRAM, WHEN RUNNING IS OBSOLETE. 


THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE’LL BELIEVE YOU. TELL HIM A BENCH HAS WET FAINT 
ON IT AND HE’LL HAVE TO TOUCH IT TO BE SURE. 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE» VOLUME» HUMIDITY» AND OTHER VARIABLES THE 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF FRESSURE 
TEMPERATURE» VOLUME>s HUMIDITY» AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 


ANY GIVEN PROGRAM» WHEN RUNNING IS OBSOLETE. 


THE ATTENTION SFAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROFORTIONAL 
TO THE LEVEL OF MANAGEMENT. 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 


TELL A HAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 


AND HE’LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE’LL HAVE TO TOUCH IT TO BE SURE. 


Example 3-8 MOVE Command (Sheet 2 of 2) 
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Text Substitution 


When you wish to correct a typing error or a string of text 
within a line, you must use the SUBSTITUTE command. It is the 
only line mode command that will perform this’ function. The 
format of the command is shown below, and Example 3-9 Shows the 
result of issuing the command. When you Select a text string for 
correction, you must supply a unique character string for the 


editor to match, or unexpected resultS may occur. The Editor 
substitutes for every occurrence of the specified string, 
regardless of surrounding characters. In the second example 


below, sS$theS$a$16:19, the editor found a match in line 17 in the 
word "other", and made the substitution to give the word "oar". 
The result is logically correct, however, not exactly what was 
intended. The correct command would be s$ the $ a $16:19 (with 
Spaces). 


The format of the SUBSTITUTE command requires a delimiter to 
Separate the fields of the command. In the first command example 
below, the slash is used to delimit the command name from. the 
String to be substituted, and that from the replacement String. 
Any non-alphanumeric character can be used aS a string delimiter 
provided you use the same delimiter in all places. An example of » 
this is shown in the second command example. You use this feature 
when you want to remove a string of characters that contains a 
Slash. 


Command Format 


*S/PROGRAM/TASK/5 <RET> 
*S$THE$A$16:19<RET> 
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PEDIT/EDT NEWS TXT 

i TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
#AWH 
TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE‘’LL SELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE‘LEL HAVE TO TOUCH IT TO BE SURE. 


ANY GIVEN PROGRAM, WHEN RUNNING IS OBSCLETE. 


THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 


THE DEGREE OF TECHNICAL COMPETENCE [S INVERSELY PROPCRTICGNAL 
TO THE LEVEL OF MANAGEMENT. 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, KUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 


PO a a Se 


OONAUMAWUN KH OHMUON DUAN 


- 


CEOB2 
#S/PROGRAM/TASK/5 
be) ANY GIVEN TASK, WHEN RUNNING IS OBSOLETE. 


1 substituticn 
#OSTHESABGIGIIO 


1G UNDER A MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
17 TEMPERATURE, VOLUME, HUMIDITY, AND OAR VARIABLES A 

3 substitutions 

#QUIT 


Example 3-9 SUBSTITUTE Command 
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Renumbering Lines 


During an active editor terminal session, it may be helpful 
to renumber the lines within the file. Although it is not 
possible to get line numbers out of sequence, they can become 
fractionalized and cumbersome to use. Issuing the RES command 
resequences the complete file beginning with 1 and incrementing by 
l for each line in the file. A range can be specified to 
-resequence a particular section of the file. If the sequence 
qualifier is used, as in the second command example below, a 
starting sequence number and an increment number can be specified. 


This command renumbers lines 1@ through the end of the file. 
Line 18 becomes line 19@ and each line after that has a line 
number incremented by 18. Line 11 becomes 118, line 12 becomes 
120. In the command, the first parameter supplies the range of 
lines to be numbered. In the command qualifier, /SEQ, the first 
parameter is the starting line number and the next parameter is 
the increment value. Example 3-18 depicts using the . RESEQUENCE 
command. 


Command Format 
*RES<RET> 
*RES 10:E/SEQ:100:10 
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#RES LO°%E /SEQ2100°10 
10 lines reseauenced 


+ ZWH 
1 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
2 AND HE’L!E SELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
3 CN IT AND HE’LL HAVE TC TCUCH IT TO BE SURE. 
4 
pe ANY GIVEN PROGRAM, WHEN RUNNING IS GSSOLETE. 
G 
7 THE ATTENTION SPAN OF A COMPUTER IS CNLY AS 
8 LONG AS ITS ELECTRICAL CORD. 
9 
100 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
110 TO THE LEVEL OF MANAGEMENT. 
120 
130 A FATLURE WIL! NOT APPEAR TILL A UNIT HAS PASSED 
140 FINAL INSPECTION. 
150 
160 UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS CF PRESSURE 
1709 TEMPERATURE, VOLUME, HUMIDITY, AND CTHER VARIABLES THE 
180 ORGANISM WILL DO AS IT DARN WELL PLEASES. 
190 
CEQB! 
#RES 
19 lines resequenced 
*# ZW 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE‘LL SELTEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE’LL HAVE TO TOUCH [T TO SE SURE. 


ANY GIVEN PROGRAM, WHEN RUNNING IS CBSOLETE. 


THE ATTENTION SPAN OF A COMPUTER IS CNLY AS 
LONG AS ITS ELECTRICAL CORD. 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS CF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND CTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 


CO bw be bee be pe be be BA bot be 


4 
454s OHO UAV PUN HH CHOMND UN + 


CEO 


td 
m 
x 
» 


DBPZ50305,303INEW.TXTF6 19 lines 


Example 3-18 RESEQUENCE Command 
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Ending the Edit Session 

To terminate the editing session and to preserve the contents 
of the EDT buffer, use the EXIT command. A file is generated with 
the name supplied when you invoked EDT and a version number. that 
is one higher than the input file version number. If you wish to 
give your file a different name than the one supplied at _ the 
beginning of your session, supply the file name along with the 
EXIT command, aS Shown in the second example below. 

The QUIT command terminates the editing session without 
Saving the buffer contents in the file. Use QUIT when you are 


just examining the contents of a file, or when you have 
inadvertently corrupted the contents of a file. 


Command Format 


*EXIT<RET> 
*EXIT NEWER.TXT<RET> 
*QUIT<RET> 


LEARNING ACTIVITIES 


1. READ Chapter 7, Line Editing, in the 
EDT Reference Manual. 


2. DO Lab Exercises 1 and 2 for this module. 
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Character Mode Features 

In contrast to line mode where the cursor is always 
positioned at the beginning of a line and operations are performed 
on a line-by-line basis, character mode allows cursor positioning 
anywhere in the text buffer, and operations can be performed on a 
character-by-character basis. EDT shows immediate results of a 
keystroke which creates a great deal of activity on the screen. 
For example, if you delete a word, the letters are removed and the 
line is adjusted to close up the space where the word resided. 

This mode makes adding and deleting text within a line 
extremely simple. Using the keypad function keys, a complete word 
can be deleted with one keystroke. The following is a list of 
features that makes character mode so attractive. 

e Free form cursor positioning 

e Dynamic display of editing operations 


e Keypad function keys that perform specified operations in 
one keystroke 


e Instantaneous addition of text 

e Help facility 

e Cut and paste operation for moving blocks of text 
e Ability to use line mode editing commands 


e Ability to change between upper- and lowercase alphabetic 
characters 


e Ability to select a range of lines to limit line width 
e Ability to set tabs 


e Ability to define key functions 
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THE KEYPADS 


Figures 3-3 and 3-4 show the keypads of the VT1@@ and VT52 
terminals and include a diagram showing each key's function. Most 
keys have two functions. To invoke the lower function, the gold 
key must be pressed first. For example, if you wish to employ the 
TOP function on a VT1@@, you would first press the gold key (PF1) 
and then the TOP (5) key. 


VT100 Keypad Functions 


= 


i ape hii fe kd 
FNDNXT | DEL L | 
| uP | DOWN I LEFT at RIGHT | | GOLD | HELP [ Fnor | ONDE 
an apa mel —+— en = = 
| otn | SECT | aPrenp DEL W 
COMMAND 


FILL REPLACE | UND W 


| sorrom BACKUP | CUT hee DEL C 


OTTOM TOP PASTE | UND C | 


| Eo | CHAR | 
CHNGCASE! DEL EOL! specINS 


| | ENTER 

L— = = —-~ suBs | 

| LINE | SELECT | | 
OPEN LINE RESET 


cape eee Dene (eter 


Figure 3-3 VT1@@ Keypad Functions 
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VT52 Keypad Functions 


Bea 


Figure 3-4 
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on ee 


DEL L | UP 
| GOLD YEEe, | UND L | RePLace 
| AGE FNDNXT} DEL W DOWN | 
commano| FIND UND W 


SECT | 


| ADVANCE | BACKUP DEL C RIGHT 
BOTTOM TOP UND C SPECINS 


veh Ne 
5 TL ee ee | 


WORD EOL 
|cinccase| be EOL| PASTE | we 


ea aa 


LINE | SELECT | ENTER 
| OPEN LINE RESET | suBs 
TK-7687 


VT52 Keypad Functions 
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Changing to Character Mode 


When you invoke EDT, the mode that is active is line mode. 
To be able to work in character mode, issue the change command (a 
line mode command) as shown in Figure 3-5. When this is done, EDT 
erases the screen and starts displaying the first 22 lines of the 
buffer. Line numbers are not displayed, as they have no’ function 
in character mode. All operations are now dependent upon cursor 
positioning. Also, EDT does not display a prompt in character 
mode to indicate that it is ready to accept commands. When the 
cursor sits on the first character and blinks, EDT is’ ready to 
accept keystrokes. 


EDIT/EDT NEWT XT 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE‘LL BELIEVE YOU, TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE’ULL HAVE TO TOUCH IT TO BE SURE. 


WNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES, 

ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 


THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE°LL BELIEVE YOU, TELL HIM A BENCH HAS WET PAINT 
ON IT AND HF*LL HAVE TO TOUCH IT TO BE SURE, 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
IRGANISM WILL DO AS IT DARN WELL PLEASES, 


ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE, 


[HE ATTFNTION SPAN OF A COMPUTER IS ONLY AS 
LING AS ITS ELECTRICAL CURD, 


THE DEGREE OF TECHNICAL COMPETEYCE IS INVERSELY PROPORTIONAL 
T) THE LEVEL OF MANAGEMENT, 


A FAILURE wILh NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 


[EOB| 


TK-7865 


Figure 3-5 Changing to Character Mode 
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Positioning the Cursor 


To position the cursor a character or a line at a time, _ the 
arrow keys on the keypad can be used, as Shown in Figure 3-6. 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE’LL BELIEVE YOU, TELL HIM A BENCH HAS WET PAINT 
QN IT AND HF’LEL HAVE TO TOUCH IT TO BE SURE, 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
QIRGANISM WILL DO AS IT DARN wELL PLEASES, 


ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE, 


CHE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
GONG AS ITS ELECTRICAL CURD, 


THE DFGREF OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TI THE LEVEL OF MANAGEMENT, 


A FAILURE wILh NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 


FUNCTION: POSITIONING THE CURSOR 
a — 
DISCUSSION: t MOVES CURSOR UP ONE LINE 


f MOVES CURSOR DOWN ONE LINE 
—® MOVES CURSOR RIGHT ONE CHARACTER 


<— MOVES CURSOR LEFT ONE CHARACTER 


TK-7862 


Figure 3-6 Positioning the Cursor (Sheet 1 of 3) 
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EXAMPLES: 
USER TYPES RESULTS 

TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE’LL BELIEVE YOU, TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE*’LL HAVE TO TOUCH IT TO BE SURE, 
UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 

——> == ORGANISM WILL DO AS IT DARN WELL PLEASES, 

Tae — er ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE, 


THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CURD. 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE’LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE‘LL HAVE TO TOUCH IT TO BE SURE, 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
Cf TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
| { ORGANISM WILL DO AS IT DARN WELL PLEASES, 
ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE, 
{__\ ae THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD, 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 


TK-7863 


Figure 3-6 Positioning the Cursor (Sheet 2 of 3) 
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EXAMPLES: (CONT) 
USER TYPES RESULTS 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE’LL BELIEVE YOU, TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE’LL HAVE TO TOUCH IT TO BE SURE, 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOUUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES, 

ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE, 


THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD, 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE’LL BELIEVE YOU, TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE*’LL HAVE TO TOUCH IT TO BE SURE, 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
QRGANISM WILL DO AS IT DARN WELL PLEASES, 


ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE, 


THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD, 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 


TK-7864 


Figure 3-6 Positioning the Cursor (Sheet 3 of 3) 
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Positioning the Cursor (Alternate Methods) 


Another method of moving the cursor (usually quicker) 
use the function keys in two key combinations, as shown in Figure 


3-7. 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE*’LL BELIEVE YOU, TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE*’LL HAVE TO TOUCH IT TO BE SURE, 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES, 


ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE, 


THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD, 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 


FUNCTION: POSITIONING THE CURSOR 


KEYPAD: 


aS te ag Sie ee a te Gl pO 
| ADVANCE | packur | | worn | cot | | LINE | 

BOTTOM | TOP | | CHNGCASE | DEL EOL | | OPEN LINE ) 
pa a VO ree (Ant, CoP Sebenatie Leer fees ty Cease oes nD aA 


is 


DISCUSSION: ADVANCE — SETS CURSOR DIRECTION FORWARD (DEFAULT DIRECTION OF 


CURSOR). MOVEMENT REMAINS IN EFFECT UNTIL BACKUP IS 


DEPRESSED. 
BACKUP — SETS CURSOR MOVEMENT TOWARD THE START OF THE FILE 
TOP — POSITIONS CURSOR AT THE TOP OR START OF FILE. 
BOTTOM — POSITIONS CURSOR AT THE BOTTOM OF THE FILE BUT 
BEFORE [EOB] SYMBOL. 
WORD — MOVES THE CURSOR ONE WORD 
WORD = ONE OR MORE CHARACTERS PRECEDED AND 
FOLLOWED BY KEY SPACES. 
TK-7866 
Figure 3-7 Positioning the Cursor (Alternate Methods) 


(Sheet 1 of 4) 
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EOL  — POSITIONS CURSOR AT THE END OF THE LINE 
LINE — POSITIONS CURSOR AT THE BEGINNING OF THE LINE 


EXAMPLES: 
USER TYPES RESULTS 

TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE’LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE’LL HAVE TO TOUCH IT TO BE SURE, 
UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 

i —_—_— aa ~~~ 7 ORGANISM WILL DO AS IT PARN WELL PLEASES, 

| ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE, 
cae ADVANCE | 

| | | BOTTOM | THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CURD, 

L ae! ba my oe a THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 


TO THE LEVEL OF MANAGEMENT, 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HELL BELIEVE YOU. TELL HIM A BENCH KAS WET PAINT 
ON IT AND HE*LL HAVE TO TOUCH IT TO BE SURE, 


fo UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
[~ ~] TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES, 


P 
| GOLD : | geass | ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 
| | THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
L 7 Ue eee! LGNG AS ITS ELECTRICAL CURD. 
THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 


TK-7867 


Figure 3-7 Positioning the Cursor (Alternate Methods) 
(Sheet 2 of 4) 
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EXAMPLES: (CONT) 


USER TYPES RESULTS 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE’LL BELIEVE YOU, TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE’LL HAVE TO TOUCH IT TO BE SURE, 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 


a | ORGANISM WILL DO AS IT DARN WELL PLEASES, 
| Eo. ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 
| DELEOL | THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 


I if LONG AS ITS ELECTRICAL CORD, 
a THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE’LL BELIEVE YOU, TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE‘’LL HAVE TO TOUCH IT TO BE SURE, 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 


f ye == “| ORGANISM WILL DO AS IT DARN WELL PLEASES, 

| LINE | ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 
| OPEN LINE | THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
| | LONG AS ITS ELECTRICAL CORD, 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 


TK-7868 


Figure 3-7 Positioning the Cursor (Alternate Methods) 
(Sheet 3 of 4) 
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EXAMPLES: (CONT) 


USER TYPES 


a Se a 
worpD | | woRD 
| CHNGCASE | j CHNGCASE | 


eer, ieee yell 


iia i) ins 
| sackue | | worn | 
| CHNGCASE | 


| 
bee edi Mtns ot 


RESULTS 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE°LL BELIEVE YOU, TELL HIM A BENCH HAS WET PAINT 
ON IT AND HF*LL HAVE TO TOUCH IT TO BE SURE, 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
JRGANISM WILL DO AS IT DARN WELL PLEASES, 


ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE, 


fHE ATTFNTION SPAN OF A COMPUTER IS ONLY AS 
LING AS ITS ELECTRICAL CURD, 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TD THE LEVEL OF MANAGEMENT, 


A FAILURE wILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE’LL BELIEVE YOU, TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE’LL HAVE TO TOUCH IT TO BE SURE, 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES, 


ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE, 


THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 


TK-7869 


Figure 3-7 Positioning the Cursor (Alternate Methods) 


(Sheet 4 of 4) 
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Inserting Text 


Inserting text in character mode is almost automatic. 
only required operation is to position the cursor on the character 


in front of where you want to add the text. When the 


correctly positioned, you type the required text. 


Shown in Figure 3-8. 


EXAMPLE: 
USER TYPES 


4) <rReT> 


ALL'S WELL THAT ENDS <RET> 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE°LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE’LL HAVE TO TOUCH IT TO BE SURE, 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN wELL PLEASES, 


ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE, 


THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD, 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 


FUNCTION: INSERTING TEXT 


KEYPAD: ANY KEYPAD KEY MAY BE USED TO POSITION 


THE CURSOR, ETC. HOWEVER, UNLIKE LINE 
MODE, THESE KEYS CAN NOT BE USED TO 
ENTER NUMERICS INTO A TEXT FILE. 


DISCUSSION: AFTER POSITIONING THE CURSOR TO THE 


PROPER POSITION, YOU CAN BEGIN TYPING 
THE DESIRED TEXT. IT WILL AUTOMATICALLY 
BE iNSERTED INTO YOUR FILE IMMEDIATELY 
BEFORE THE CURSOR’S POSITION. 


RESULTS 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE’LL BELIEVE YOU, TELL HIM A BENCH HAS WET PAINT 
ON IT AND HF’LL HAVE TO TOUCH IT TO BE SURE, 


ALL'S WELL THAT ENDS. 
UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 


TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES, 


ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE, 


THE ATTFNTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CURD. 


THE OFGREF OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
T2 THE LEVEL OF MANAGEMENT, 


A FAILURE wILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 


TK-7870 


Figure 3-8 Inserting Text 
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Deleting Text 


To delete text, first position the cursor to the line, 
character, or word that is to be deleted, and then press the 
appropriate delete key on the keypad. If a piece of text was 
deleted in error it can be restored by first pressing the GOLD key 
and then the appropriate undelete key (UND C, UND L, UND WW). 
Figure 3-9 shows the process of deleting text. 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE’LL BELIEVE YOU, TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE*LL HAVE TO TOUCH IT TO BE SURE, 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 


TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES, 


ALL'S WELL THAT ENDS. 


ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE, 


THE ATTENTION SPAN OF A COMPUTER IS QNLY AS 
LONG AS ITS ELECTRICAL CORD, 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 


A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 


FUNCTION: DELETING TEXT 
ee a teres ea (pe a ee ea 
KEYPAD: | DELC | | DELL | | DEL W | | EOL 


| uNDC a | j UND Ww | BEL EOE 


es ee reed Nee eed I ete ad 


DISCUSSION: AUTOMATIC DELETE FUNCTIONS ARE AVAILABLE FOR 
CHARACTER, WORD, LINE, OR PARTIAL LINES. IN 
ADDITION, THE DELETE KEY LOCATED ON THE 
KEYBOARD CAN BE USED TO DELETE A CHARACTER. 


--s 
1 pbeLc | — DELETES THE CHARACTER ON THE CURSOR. 
J unDc | 
Lu 
1 DELETES A LINE FROM WHERE THE CURSOR 


! DELL | IS TO THE END OF THE LINE INCLUDING THE 
| CARRIAGE RETURN AND LINE FEED. 


cere ee 
apace | 
peLw | — DELETES A WORD INCLUDING THE SPACES 

| BEFORE AND AFTER. 

eens 
SS bos 
I corp | | fOL. | — DELETES A LINE FROM WHERE THE CURSOR 
[| ,OEL EOL} IS TO THE END OF THE LINE. 


eae aes ee | 


TK-7871 


Figure 3-9 Deleting Text 
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Help Function 


The Help key on the keypad provides the same function as 
typing help in line mode. It provides a keypad/function diagram 
and instructions on how to get help on each of the keys used in 
character mode (Figure 3-19). 


Cr ae pow a ee, aR eee Ag oe ee | 

er ee | | | | FNONXT | DELL | 

| | | lemperetitt. |b Sea tiete ul HELP 

| bo fy LEFT) | ORIGHT | 

P | | 

ae ee eee See eer es 
: PAGE SECT | APPEND DEL w | 
COLO] PANN) FILL REPLACE 

DELETE RUBOUT CHARACTER 

LINEFEED RUBOUT WORD 

BACK SPACE BACKUP TO BEGINNING OF LINE | ADVANCE | BACKUP | CUT | DELC | 

CTRL/A COMPUTE TAB LEVEL 

CTRL/D DECREASE TAB LEVEL 

CTRL/E INCREASE TAB LEVEL ee 

CTRL/K DEFINE KEY 

CTRL/T ADJUST TABS | worp EOL CHAR 

CTRL/W REFRESH SCREEN | 

CTRL/Z RETURN TO LINE MODE 


CHNGCASE DEL EOL SPECINS 


TYPE A KEY FOR HELP ON THAT KEY. 
TO EXIT, TYPE A SPACE. | SELECT 


OPEN LINE 


TK-7668 


Figure 3-18 VT1@@ Keypad Editing Help Text 


Exiting Character Mode 


When your work in character mode is finished, you can save 
your edit session in either of two ways. 


1. Press the GOLD and then the COMMAND function key. Type 
EXIT after the prompt and press the ENTER function key. 


2. Press <CTRL/Z> which returns you to line editing. After 
the (*) prompt, type EXIT <RET>. 
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LEARNING ACTIVITIES 
READ the following in the EDT 


e Chapter 2, Sample Editing Sessions - 
Keypad Editing Section 


e Chapter 5, Keypad Editing 


DO Lab Exercises 3 through 6 for this 
module. 
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FILE AND DIRECTORY MAINTENANCE 


INTRODUCTION 


Most work on the system, directly or indirectly, involves 
files. You will need to obtain files from other users and/or 
transfer your own files to them, and keep track of files that you 
have created. System commands are available to allow the user to 
maintain files and directories. Some available functions are: 

e Listing directories of files 

e Deleting unwanted files 

e Renaming files 

e Making copies of files 


e Displaying files at the terminal 


e Printing files on the system printer 


This module focuses on these file operations. 


OBJECTIVES 
1. List directories of files. 
2. Delete unwanted files. 
3. Rename files. 
4. Make copies of files. 


5. Inspect the contents of files, uSing the terminal or a 
printer. 


6. Set the access which other users have to your files. 


RESOURCES 


1. RSX-11M/M-PLUS Command Language Manual 


2. Introduction to RSX-11M/M-PLUS 
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FILE STRUCTURE 
FILES-11 


Another facility of an operating system that benefits its use 
is the task of storing, maintaining and locating files on 
auxiliary storage devices. This is done by a_ software system 
called FILES-11l. To be able to locate and maintain files on 
volumes mounted on disk drives, floppy disks and DECtapes, 
FILES-11 uses a two-level directory structure, as shown in Figure 
4-1. For each volume, the structure consists of one Master File 
Directory (MFD) and one User File Directory (UFD) for each user on 
the volume. 


Master File Directory (MFD) 


The Master File Directory is a file located in the UFD [29,8] 
named @@0@000.DIR. It contains a list of all the UFDs located on 
the volume. 


User File Directory (UFD) 


In turn, a User File Directory (UFD) (Figure 4-2) is a 
directory file that keeps track of all files on the volume 
belonging to a user. A UFD is created when an account is 
established for a user, and is identified with the user's UIC. 
For example, if your UIC is [385,393], you would have a_ directory 
file in UFD [8,8] named 395393.DIR. 


A UFD can also be created later by using the DCL command 
CREATE/DIRECTORY. This command is also used to create a UFD on 
another volume, or another UFD on the same volume. A user may 
have a UFD on many different devices, but one device is set up to 
be the default device for the user. 
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[0,0] 000000.DIR 


001002.DIR 
001054.DIR 


005002.DIR MASTER 
005003.DIR FILE 
DIRECTORY 
305303.DIR 
305304.DIR 
PROG.FTN 
PROG.LST 
PROG.MAP USER 
FILE 
PROG.TSK DIRECTORY 


LOGIN.CMD 


[0,0] 305303.DIR 


[0,0] 001002.DIR [0,0] 005003.DIR 


PROG.FTN PROG.LST PROG.MAP PROG.TSK FILE 


[305,303] [305,303] [305,303] [305,303] 


TK-7680 


Figure 4-1 FILES-11 Directory Structure 


FILE AND DIRECTORY MAINTENANCE 


305303.DIR 
305304.DIR 


SY: [305,303] 


PROG.MAP 


VIP.OBJ 
PROG.OBJ 
PAYROLL.CBL 


YOUR DIRECTORY ANOTHER USER’S DIRECTORY 


TK-7670 


Figure 4-2 User File Directories 
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User Default UFD 


When you successfully log in, the operating system grants you 
access to your User File Directory and all the files contained 
within it. This becomes your default UFD. Whenever a UFD is 
required syntax and is not supplied, the operating system will 
assume you mean your default UFD. It is possible and often to 
your advantage to change your default UFD to something other than 
the one you log in to. This is done using the DCL command SET 
DEFAULT, as shown in Figure 4-3. Example 4-1 shows the results of 
issuing the DIRECTORY command before and after using SET DEFAULT. 
The DIRECTORY command (which can be shortened to DIR) provides a 
listing of the files contained in a_ UFD. The first directory 
listing in the example is for UFD [385,383]. Because the UFD was 
not specified with the DIR command, the system assumes the user's 
default UFD. After issuing SET DEFAULT to change the default UFD 
to [305,304], DIR produces a listing for the second UFD. 


User Default Device 


It is also possible to change your default device. This is 
useful when you wish to work ona disk volume other than the 
default device set up for you when your account was’ established. 
By changing the default device, you will save having to specify 
the device every time you issue a command. SET DEFAULT is also 
used to change the default device. In both cases, the change is 
effective until the command is issued again or the user logs off. 


System UFDs 


Table 4-1 lists special UFDs established by the system 
manager when the operating system is generated. These UFDs 
contain files related to a particular subject. For example, the 
text files used to display HELP messages are stored in LB:[1,2]. 
The login message file is also stored in LB:[1,2]. 


Table B-3 in the RSX-11M/M-PLUS System Management Guide gives 
a complete list of the system UFDs. 
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DB2: DKO: DY1: 


ci 


DEFAULT UFD: 


[305,303] 


DEFAULT DEV: 


>SET DEFAULT DY1: [305,304] 


DB2: DKO: DY 1: 


iil 
chit 


1o)] 
” 
N 


(al 


DS2: 


cH 


TK-7679 


Figure 4-3 Changing the Default UFD and Device 
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>DIR 


Directory DK230305%3032 


1S-BDEC-81 11339 


LOGIN.CMD3$1 1. 04-AUG-~-81 08343 
VIP.TSK#il 4. C 14-AUG-81 10248 
FAYROLL. CBRL 351 Ze OS-JAN-81 15231 
INFO. TXT#1 40, O7-JUL-80 12347 
LOGOUT.CMD3S 1, 28-MAY-80 08:49 
FROG.FTNG 1 be 14-AUG-81 08:35 
FROG,OBJ31 0. 14-AUG-81 08336 
FROG.LST#1 0. 14-AUG-81 083364 
FROG.OBJ32 Se 14-AUG-81 083364 
FROG,.LST#2 11, 14-AUG-81 087234 
FROG. FTN32 be 14-AUG-81 08:36 
FROG.FINGS &s 14-AUG-81 08:37 
FROG. TSKSE1 b+ C 14-AUG-81 08:37 
MACIO.MAC3SS 3. O4-AUG-81 092314 
MACTO.ORJSS 1, 14-AUG-81 10346 
MACIO.LST#1 ae 14-AUG-81 10346 
DQIRECTORY.LST#1 3. 18-AUG-81 16228 
XYZ-MAC#1 3, 19-AUG-81 09:43 
XYZ.TSK3$1 4, C 19-AUG-81 09343 
VIF.OBIF3 1. 19-AUG-81 09346 
VIF .MACES 3s 19-AUG-81 09346 
VIF.OBI34 le 19-AUG-81 09347 
VIF.ORJSS 1. 19-AUG-B1 09347 
VIFLLSTES Se 19-AUG-81 09347 
MACIO.MAC37 3 19-AUG-81 09348 
MACIO.MACSS 3. 19-AUG-S1 09348 
MACIO.MAC#10 3. 1%-AUG-81 09349 
FRIMES.TSK31 48. C 197-AUG-81 413257 
Total of 193./199, blocks in 28. files 

“SET DEFAULT [£305+3047 

PIIR 

Directory [IK23030573047 

1IS-DEC-81 11340 

LOGIN.CMD31 1, 04-AUG-B1 08:43 
LOGOUT.CMDSS 1. 28-MAY-80 08:49 
STARTUP .CMD357 14. O6-JUL-81 10°53 
FRIMES.MAC3 43 8, 1S-JAN-8S1 14315 
ALIVENTURE.TSK31 151. C O8-AUG-81 14622 

CLAMBAKE.TXT#1 3. OS-AUG-81 162318 
NOTICE.TXT3i 14. 16-MAR-B1 10334 
FRIMES.OBJ91 Qe 14-AUG-81 11:09 
FRIMES.LST#1 13. 14-AUG-81 11309 
FRIMES, TSK51 48, l 14-AUG-81 11:09 
FRIMES.MAF S14 3. 14-AUG-81 11309 
A,MAC#2 3. 18-AUG-981 14230 
VIF.TSK31 4, C 19-AUG-81 13°58 
FROG. TSKE1 &. C 18-AUG-81 162331 
Total of 269,./273. blocks in 14. files 


Example 4-1 How the Default UFD Works 
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Table 4-1 Special User File Directories 


As ao 
cS _ 
Ct 


= ine 
RRs s 


SOS 


wh re 
Neues = = 
So 


LEARNING ACTIVITY 


1. READ Sections 4.1 through 4.1.4, in 
Chapter 4 of the RSX-11M/M-PLUS Command 


Language Manual. 
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MAINTAINING A USER FILE DIRECTORY 


When your terminal session activity has been heavy, your UFD 
may contain unnecessary files. You may want copies of files from 
someone else's UFD, or to copy some of yours to another UFD. 
Although there is no limit to the number of files you may have in 
your UFD, there is a physical limit to the number of files’ that 
can exist onavolume. Therefore, some file maintenance must be 
performed to ensure that unneeded files are removed to free up 
disk space for everyone's use. Table 4-2 lists some of the DCL 
file maintenance commands that will maintain your UFD and _ other 
UFDs. The DCL command line is reviewed below. 


Command Formats 


>DIR/FULL SAMPLE.FTN;3,Other.FTN<RET> 
—— ne ee 


| 


00 0 O ° ° © o 

> COPY | [305,301]VIP.TSK [3805,303]VIP.TSK<RET> 
° 0 ° ° o o 
© 


ti aN 

-> RENAME <RET > 
Old file name? SAMPLE.FIL <RET> 
New file name? NEW.TXT <RET> 


DCL command name file specification list delimite 


qualifier delimiter input file specification 
command qualifier output file specification 


command delimiter command line terminator 


00000 
60000 


file specification 
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Table 4-2 


ne 
cee ees 
oe 


os 
ee 

RARER SE 
tt 


saneasnongcen 


pe A 

EROS 

eee 
so 


File Maintenance Commands 
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Defaults in File Specification 


Defaults allow you to specify files without having to type in 
the full specification. Shown below is an example of using 
defaults to your advantage. The results of issuing the DIR 
command are shown in Example 4-2. Refer to Table 4-3 for the 
rules governing the use of defaults in a file specification. 


Command Format 


>DIR VIP.MAC;3,MACIO,.TSK,;4 


eee eee” 


a sR 
5 J 


The first file specification is explicit on all fields. 


The file type is implied, and the default taken. The default 
file type is .MAC from the previous file specification. The 
version number is implied; the default is always the latest 
version no matter what the previous file specification states. 


3) The file name is implied, and the default taken. The default 
file name is MACIO from the previous file specification. 


@ The file name and type are implied from the previous file 
specification. Therefore, this file specification equates to 
MACIO.TSK;4. 


6 In all cases the device and UFD are implied, the default being 
the user's default device and UFD. 
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Table 4-3 Defaults in a File Specification 


. 
: 


Peeves ae 


eee 


Pe ee 
ee 


ea: 


SOR ee 


ESR 


SOIR VIF «MACH SsMACTOr. TSK 54 


Directory DK2306305%303) 
1S-DEC-81 112346 


VIF.MAC$3 3. 19-AUG-B81 09746 
MACTO.MAC#10 3. 19-AUG-81 09349 
MACIO.TSKSS 4, C i5-DEC-B81 11243 
MACIO.TSK#4 4, C i15-DEC-381 11243 


Total of 14,./18. blocks in 4. files 


Example 4-2 Using Defaults in a File Specification 
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Listing Directories 


When you wish to list the files that are in your directory, 
use the DIRECTORY command. It is also used to list files in other 
directories, to list a particular group of files (Such as all 
MACRO source files), to search a group of directories for a 
particular file, to determine the amount of free space on a 
device, and to determine the amount of space used by files ina 
UFD. Example 4-3 shows the results of issuing the directory 
commands in the examples. Refer to the notes for an explanation 
of the results. 


Command Format 


>DIR 

>DIR VIP.MAC 

>DIR/FULL PAYROLL.CBL 
>DIR [305,304] 

>DIR/BRIEF 

>DIR/SUMMARY 

>DIR/PRINT 
>DIR/OUTPUT:DIRECTORY.LST 
>DIR/FREE DBO 
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1] ~DIR 


@ Directory IK2:0305,3033 


ae’ ae 11338 ° e © 
LOGIN.CMD$1 1. O4-AUG-81 08343 
VIF.TSK31 4. C 14-AUG-81 10248 
FAYROLL.CBLS51 2s OB-JAN-81 15331 
INFO. TXT 1 60, 07-JUL-80 12247 
LOGOUT.CMDsS 1. 2B-MAY-80 08249 
FROG. FTNS1 Gs 14-AUG-81 08:35 
FROG.OBJ#1 0. 14-AUG-81 08336 
FROG,LST#1 Oe 14-AUG-81 08236 
FROG.OBJ92 Se 14-AUG-81 08236 
FROG.LST52 11. 14-AUG-81 08236 
FROG.FIN#2 és 14-AUG-81 08236 
FROG,FITNS3 be e 14-AUG-81 08337 
FROG. TSK#1 be C 14-AUG-81 08237 
MACIO,.MACSS 3. O4-AUG-81 09:14 
MACIO.OBJSS 1. 14-AUG-81 10:44 
MACIO.LST#1 Se 14-AUG-81 10246 
DIRECTORY.LST31 3. 18-AUG-81 16328 
XYZ.MAC#1 3. 19-AUG-81 09343 
XYZ.TSK31 4, C 19-AUG-B81 09243 
VIF .OBJ#3 1. 19-AUG-81 09346 
VIF .MACIS 3. 19-AUG-81 09346 
VIF .OBJ#4 1. 19-AUG-81 09347 
VIF .OBRJSS 1. 19-AUG-81 09347 
VIP.LST#S Se 19-AUG-81 09347 
MACIO.MAC37 3. 19-AUG-81 09:48 
MACIO.MATIS 3. 19-AUG-81 09348 
MACIO.MAC310 3- 19-AUG-81 09349 
FRIMES.TSKRE1 46, C 19-AUG-81 13257 

6 Total of 193.7199. blocks in 28. files 

6 »DIR VIF «MACs 
Directory DIK23£3052303] 
15-DEC-81 11345 
VIF MACS 3. 19-AUG-81 09346 
Total of 3./5. blocks im 1. Pile 

0) +DIR/FULL FAYROLL.CBL 
“Directory IK2{0305%3033 
15-DEC-81 11247 
FAYROLL.CELS512 (1722) 24/25 O8-JAN-81 15°31 


(12) C3IOS*SOZICRWEDsRWEDsRWED RI L4-AUG~-81 10251¢(10.) 


Total of 2.7/2. blocks in 1. file 


% 


Example 4-3 DIRECTORY Command Samples (Sheet 1 of 3) 
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sa) Directory OIKR23;0305%304] 
15-DEC-81 11348 


LOGIN. CMDS 1 1, 
LOGOUT, CHEFS 1. 
STARTUP. CMDSS7 14, 
PRIMES «MAC? 43 8. 
AIVENTURE.TSN#1 151, 
CLAMBAKE.TXT#1 3, 
NOTICE.TXT#1 14, 
PRIMES OBJ#1 ae 
PRIMES.LST#4 13, 
PRIMES.TSK$1 46, 
PRIMES. MAF 1 3. 
AeMACS2 3. 
VIF.TSK31 4. 
PROG. TSK51 bs 


Total of 269./273,. blocks in 


@ 2UIR/ERIEF 


irectory DR23 £305,303 


LOGIN. CMDs1 
MACIO.TSK35 
MACIO.TSKS4 
VIF .MACS 3 
VIF.TSKs1 
PAYROLL .CBLS4 
INFO. TKTEL 
LOGOUT.CMDS 
FROGsFTNS 1 
FROG-OBJ#1 
FROG .LST51 
FROG.OBJ#2 
FROG.LST#2 
FROG+FTNS2 
PROG.FTN: 3 
FROG. TSKF4 
MACTIO.MACHS 
MACIO.OBIS 
MACIO.LSTEL 
DIRECTORY.«LST$2 
XYZ+MACH 1 
XYZ.TSK31 
VIF .OBIS3 
VIP .ORJ34 
VIP.,OBJ5S 
VIP.LSTSS 
MACIO.MACS7 
MACIO.MAC#S 
MACIO.MACH10 
PRIMES.TSKG1 


Example 4-3 
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04-AUG-81 
28-MAY-90 
06-JUL-81 
15-JAN-81 
OS-AUG-81 
05-AUG-81 
16-MAR-B81 
14-AUG-81 
14-AUG-81 
14-AUG-81 
14-AUG-81 
18-AUG-81 
19-AUG-B81 
18-AUG-81 


14. files 


DIRECTORY Command Samples 


08243 
08349 
16353 
16315 
16329 
16318 
10334 
11209 
11309 
11209 
11309 
16230 
13:58 
14:31 


(Sheet 2 of 3) 
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® POIR/SUMMARY 


Storage used/allocated for Directory [UK2°039523033 
15-DEC-81 11348 


Totel af 201./207. blacks in 30. files 


@ »DIR/OUTPUT 3 RIRECTORY «LST 
SOIR DIRECTORY.LST 


Directory DK2:;03057 303) 

1S-DEC-81 11349 

DIRECTORY.LST32 4, 1S-DEC-81 11749 

Total of 4.74. blocks im 1, file 

OIR/FREE 

[UK2? has 4091. blocks freer 709. blocks used out of 4800, 


Largest contiduous seace = 2242, blocks 
239. file neaders are freer 35, headers used aut of 294, 


@ “UIR/FREE LBL: 


DRi: has 35407. blocks frees 285263, blocks used out af 340670, 
Largest contiguous space = 334634. blocks , 
13885. file headers are freer 11708. headers used out of 2ES93, 


Example 4-3 DIRECTORY Command Samples (Sheet 3 of. 3) 
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Notes on Example 4-3 


@ command to obtain a listing of files in the user's default 
device and UFD. 


Device, UFD for which the directory, day, and time are 
given. 


File name, type and version. 
Size of the file in blocks (decimal). 
Creation date. 


Creation time. 


C indicates file stored contiguously on the _ disk. L 
indicates file is locked (not properly closed). You will 
not be able to read this file. 


Summary including the number of blocks used, the number of 
blocks allocated, and the number of files. 


Directory on a specific file. 

Example of full directory. 

File ID. 

Owner of the file. 

Protection setting. 

Obtaining a directory of another UFD. 
Obtaining a quick directory of the user's UFD. 
Obtaining only summary information. 


Putting the directory information into a file. 


@eeeceecoeoesedacd O 


Obtaining information on the volume. 
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Deleting Files 


When you wish to remove a file from your UFD, you may do_- So 
by using the DELETE command. Care must be taken to ensure that 
the correct file specification has been supplied or you may delete 
a needed file. If a file is deleted by mistake, it may be 
possible to recover that file from the system backup tapes’ and 
disks. This depends upon when and if your system manager has 
performed a backup. Backing up a volume is copying its files to 
another disk, or to a magnetic tape for security purposes. The 
DELETE command allows you to selectively delete files from a UFD 
(as shown in the fourth command example below) and also to provide 
a log of the files that have been deleted (third command example). 


Example 4-4 provides some samples of the DELETE command. 


Command Format 


>DEL MOV.DAT;* 

>DEL A.*:* 

>DEL/LOG A*.OBJ;*,B.MAC;5 
>DEL/QUERY +*.MAC;* 
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“DIR MACTO,.TSKsx 


Directory [K2{;03057303) 
15-DEC-81 11;51 


MACIO.TSNSS 4, C 1S5-DEC-81 11343 
MACIO.TSK#4 4, C 15-DEC-81 11343 
MACIO.TSK#1 4. C iS5-DEC-81 11:50 
MACIO.TSK33 4, C 15-DEC-81 11350 
MACIO.TSN$2 4. C 15-DEC-81 11350 


Total of .20./20, blocks in 3S. files 


Ss 


= TEL/LOG MACTO. TSN? & 


The following files have heen deleted: 
DR2°C305» 303 IMACIO.TSKSS 
UK2°0305s303IMACIO. TSK 4 
UK23 C305» 303 IMACIO. TSK 1 
QK2:0305*3033MACIO.TSK33 
DK2{C305*303IMACIO.TSKE2 


sTIIR MACTO.*#X 


Directors DK230305%303] 
15-DEC--81 11252 


MACIO.MACS5 3+ 04-AUG-B1 09314 
MACIO.OBJS5 1. 14-AUG-81 10246 
MACIO.LST$1 we 14-AUG-81 10°46 
MACIO.MACs7 Se 19-AUG-81 09348 
MACIO.MACS6 3. 19-AUG-81 09248 
MACIO.MAC#10 3. 19-AUG-81 09349 


Total of 18,./22. blocks in 6. files 


TEL &*.+LST sx 
STIR K-LSTo* 
DIR -- No such file(s) 


Example 4-4 DELETE Command Samples 
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Purging Old Files 

To ensure that at least one version of a file is always 
retained in your UFD after deleting files, use the PURGE command. 
This command offers the option to save a variable number of 
versions of a file. This ability is especially useful after a 
series of editing sessions, to clean up unwanted files. It is 
also useful to purge all files in your UFD at the end of the day. 
This frees up storage space on the volume and makes it available 
for all to uSe. 


Example 4-5 shows how to purge files. 


Command Format 


>PURGE VIP.MAC 
>PURGE/LOG A.MAC,B.* 
>PURGE/KEEP:3 C.LST 
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“DIR VIF «MACH 


Directory DK230305%303) 
15-DEC-81 11354 


VIF .MACS 1 3. 
VIF.MAC$2 3e 
VIF. MACS 3 3. 
VIF.MACS 4 3. 
VIF.MACSS 3. 


Total of 15./17. blocks in 5. 


> 


>FURGE VIF MAC 
SOIR VIF MAC? x 


Directors DK23£3057303) 
15-DEC-81 11:58 


VIFP.MACSS 3s 


 15-DEC-81 


15-DEC~-681 
19~-AUG-B1 
15-DEC-81 
1S-nEC-8i 


files 


15-DEC-81 


Total of 3.73. blocks in 1. File 


~DIR VIF «LSTIX 


Directors IK2303052303] 
1IS-DEC-81 12301 


VIF.LST51 ae 
VIF.LST32 ve 
VIF .LST#3 we 
VIP .LST$4 Se 
VIP.LSTES Se 
Totél of 25./25. blocks in 5. 


Seurde/log virslst 


The following files have been 
UK2¢C3057/3033VIF.LSTH1 
DK2:;£305*303VIF.LST#I2 
DK2:;0C305*303IVIF.LSTI3 
DK2¢0305*s303IVIF.LSTI4 


ee 
o 


15-DEC-81 
1S-DEC-81 
15-DEC-61 
15-DEC-81 
15-DEC-81 


files 


deleted: 


11353 
11353 
09346 
11353 
11353 


11353 


11359 
11359 
12300 
12300 
12200 


Example 4-5 Purging Files (Sheet 1 of 
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Sdir vireobiusk 


Directory DK2:0305%303] 
o 15-DEC--81 12302 


VIF .OBJ6 1, 15-DEC-81 11359 
VIF .OBJs7 1. 1S-DEC-81 11259 
VIF.OBJs10 1. 1S-DEC-81 11259 
VIF .OBJ511 1. 1S-DEC-81 11359 
VIF.OBJ#12 1. iS-DEC-81 12:00 
VIF. OBJ513 1. 15-DEC-81 12:00 
VIP,OBJ514 1. 15-DEC-81 12300 
VIF -OBJ#3 1. 19-AUG-B81 09346 
VIF .OBUs 4 1. 19-AUG-81 09347 
VIF .OBJES 1. 19-AUG-81 09347 


Total of 10./10. blocks in 10. files 


“ee, 
Sreurde/keert3 vir-eobd 
edir vir-+obu?k 


Directory IK230305%303] 
15-DEC-81 12°02 


VIF.OBJ312 1. 15-DEC-81 12:00 
VIF.ORJ#13 1. 15-DEC-81 12:00 
VIF.OBU314 : es 15-DEC-81 12200 


Total of 3./3,. blocks in 3. files 


Example 4-5 Purging Files (Sheet 2 of 2) 


Notes on Example 4-5 


@ Directory of VIP.MAC before and after using the purge 
command. The latest version is retained. 


@ Example using /LOG qualifier on the purge command to 
report deleted files. 


P34 Example using the /KEEP qualifier of the purge command, 


which in this case retained the latest three versions of 
file VIP.OBJ. 


201 


FILE AND DIRECTORY MAINTENANCE 


Copying Files 


The COPY command is used to make a copy of a file. In 


addition to creating a copy, the command makes the necessary 
entries into the directory structure so that the file can be 
located at a future time. The command can be used to copy files 
within a UFD, between UFDS on the Same device, and between 
devices. It is also used to merge multiple files into one file. 


Command Format 


>COPY VIP.MAC [305,304]VIP.MAC 
>COPY VIP.TSK,PROG.TSK [305,304]*.* 


>COPY 
From? VIP.MAC 
- To? [805,304]*.* 


“COPS Virp.smac C305s304]virp.mac 


Sdir C305» 304]lvir.mac 


Directory DK2303057304) 
15-DEC-81 12303 


VIP .MACS 1 oe 1S-DEC-81 12303 


Total of 3./3. blocks in 1, file 


PCOFY 
From? vir. tskerrog. tsk 
To? C305? 3041. 


Example 4-6 COPY Command 
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Renaming Files 


The RENAME command is 


version 


of 


a file. 


used 


Simple alters the directory entry. 


Command Format 


>RENAME A.MAC B.MAC 
>RENAME A.MAC A.MAC;2 
>RENAME A.* B.* 


Example 4-7 


“ 


>RENAME VIF.MAC A+MAC 


>InTR 


Directory DK230305»304) 


15-HEC~81 


LOGIN«CMI$1 
LOGOUT,.CMIs5 
STARTUP .CMDSS7 
FRIMES.MAC#43 
ALDVENTURE.TSKS1 
CLAMBAKE.TXT#1 
NOTICE.TXT$i 
PRIMES ORJ#1 
PRIMES.LST#1 
PRIMES .TSKS1 
PRIMES» MAP #1 


A+MACS1 
VIF.TSK31 
PROG. TSK#1 
VIF.TSKS2 
PROG. TSK#2 


Total of 279./283, 


blocks in 


203 


on|Ing 


to 


04-AUG-81 
28-MAY-80 
06-JUL~-81 
1S5-JAN-81 
03-AUG-81 
05S-AUG-81 
16-MAR-81 
14-AUG-81 
14-AUG-81 
14-AUG-81 
14-AUG-81 
15-DEC-81 
19-AUG-81 
18-AUG-81 
15-DEC-81 
15-BDEC-31 


16. files 


change 
It does not make a new copy of the file; 


the 


087343 
08349 
10:53 
16315 
16329 
16318 
10°34 
11309 
11:09 
11309 
11309 
12303 
13°58 
16331 
12304 
12:04 
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> RENAME A+MAC A.MACS2 
2DIR 


Ttirectory DK230305%304] 
1S5-DEC-81 12308 


LOGIN.CMI51 1. 04-AUG-81 08:43 
LOGOUT.CMDsS 1, 28-MAY-80 08349 
STARTUF .CMD3 37 14, 06-JUL~-81 10253 
FRIMES.»MAC#43 8. 1S5-JAN-81 16315 
ALIVENTURE.TSK31 151. C O8-AUG-81 16329 
CLAMBAKE.TXT#1 3. OS-AUG-81 16318 
NOTICE.TXT#1i 14, 16-MAR-81 16334 
FRIMES.OBJ31 2s 14-AUG-81 11369 
PRIMES.LST#$1 13, 14-AUG-81 11309 
FRIMES.TSK#1 46, C 14-AUG-81 11309 
FRIMES.MAF #1 3. 14-AUG-81 11309 
A-MAC#2 3, 15-DEC-81 12203 
VIF.TSK31 4. C 19-AUG-81 13358 
PROG. TSK31 &- C 1i18-AUG-81 16231 
VIP.TSK$2 4. C 15-DEC-81 12204 
FPROG.TSK$2 6. C 15-nEC-81 12:04 
Total of 279./283. blocks in 16. files 

»RENAME VIF LKIK Akd* 

~DIR Askdx® 

Directory DBK2363057303] 

15-DEC-81 12306 

A»MAC35 3. 15-MEC-81 11:53 
A. TSK31 4, C 14-AUG~-81 102348 
A,OBJ312 i. 15-REC-81 12:00 
A.OBJ513 1. 15-DEC-81 12200 
A.ORJ314 1. 15-DEC-81 12200 
A LSTIS S. 15-DEC-81 12200 
Total of 15./15. blocks in 6. files 
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INSPECTING THE CONTENTS OF FILES 


The contents of a file can either be displayed on your 
terminal (hard-copy or CRT) or sent to a line printer for fast 
hard-copy output. Only ASCII files should be displayed or 
printed. Other files such as object files and task image files 
are in a format understood only by a machine. Displaying them at 
your terminal or on the printer produces undesirable results. 


Displaying File Contents at Your Terminal 


You will frequently want to inspect the contents of a file 
quickly without using an editor. This is done by issuing the TYPE 
command. The contents of the file are then displayed at _ the 
receiving speed of your terminal. When using a CRT, it is useful 
to use the Scroll key or <CTRL/S> and <CTRL/Q> to aid in reading 
the data. Typing a non-ASCII file, such as an object file or a 
task image file, to a CRT produces undesirable results. It is 
also possible that the combinations of characters created by the 
interpretation of non-ASCII data will cause certain terminal 
features, like holdscreen, to be set. In the case of hard-copy 
terminals, the interpretation of non-ASCII data may cause form 
ejects and line feeds to spew paper behind the terminal. 


Command Format 


>TYPE NEW.TXT 

>TYPE DK1:[305,303]MACIO.MAC 
>TYPE VIP.LST:3 

>TYPE LB:[1,2]DCLLOGIN.HLP 
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TYPE NEW. TXT 

TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE’LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE’LL HAVE TO TOUCH IT TO BE SURE. 


ALL’S WELL THAT ENDS. 


UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF FRESSURE 
TEMPERATURE? VOLUME» HUMIDITY» AND OTHER VARIABLES THE 
ORGANISM WILL 20 AS IT DARN WELL PLEASES, 

ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 


THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 

TELL & MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

AND HE’LL BELIEVE YOU. TELL HIM A BENCH HAS WET FAINT 

ON IT AND HE’LL HAVE TO TOUCH IT TO BE SURE, 


Example 4-8 Using the TYPE Command 
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Displaying Files on a Line Printer 


To obtain a hard copy of a text file on the line printer, 
issue the PRINT command in one of the formats shown below. An 
entry will be placed in a list managed by a task called the Queue 
Manager, and when the printer is available the file will print. 
This command haS many qualifiers that enhance its’ use. For 
printing more than one copy at a time, the /COPIES:n qualifier is 
used. If special forms are needed when the job is’ printed, that 
requirement is indicated by using the /FORMs:n qualifier. nisa 
number and specifies the type of form . The correlation between 
the number and type of form is a site consideration that varies 
from location to location. The first page that is printed on a 
print job is called the job flag-page and contains information 
regarding the job, i.e., the file name, the date and time of 
printing. Before each file is a file flag-page, giving 
information about the file. When printing multiple files with one 
print command, there will be one job flag-page and no file flag- 
pages printed. 


Command Format 


>PRINT VIP.MAC 

>PRINT/COPIES:2. INFO.TXT 
>PRINT/FLAG_PAGE  INFO.TXT,VIP.MAC/CO:2 
>PRINT/PRIORITY:100 VIP.MAC 
>PRINT/DELETE INFO.TXT 
>PRINT/FORMS:1 PROG.LST 
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PRINT Command Defaults 


/NO DELETE 
/COPIES:1 

/ FORMS: @ 
/PRIORITY: 59. 
/NOFLAG_ PAGE 


LEARNING ACTIVITIES 


1. READ the sections. on the following 
commands in Chapter 4 of the 


RSX-11M/M-PLU Command Language Manual. 


Directory 
Delete 
Purge 
Copy 

Type 
Print 
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PROTECTING YOUR FILES 


In a multiuser system, it is advantageous to be able to 
protect files from being deleted or corrupted by unknowing users, 


and to provide data security when it is necessary. In the 
RSX-11M/M-PLUS FILES-11 system, this is provided through two file 
attributes; file ownership and file access’ rights. Every file 


has stored with it the owner of the file and the access privileges 
that have been granted to the owner and other users of the system. 
In addition, access’ rights can be established on a UFD and on a 
volume. To be able to access a file, a user must meet’ the 
conditions at all three levels. 


File Ownership 


Every file has stored with it the UIC of the user who created 
the file. (Refer to item 12 in Example 4-3 to review how to 
obtain this information.) In item 1 in Example 4-9, the person 
who owns the UFD is also the owner of the file PAYROLL.CBL located 
in that UFD. When a uSer or a task attempts to access the file, 
the UIC of the requesting user or task is compared with that of 
the owner of the file and access is granted or denied depending 
upon that relationship. The owner of a file does not always 
coincide with the owner of the UFD in which the file resides, as 
in item 2 of Example 4-9. 


Figure 4-4 illustrates the transfer of file ownership. 


> DIR/FULL PAYROLL. CBRL 
Directory DR2$£305 303] 
15-DEC-81 11347 


oe FAYROLL.CBL#1 (1792) 2/2, OB8-JAN-81 15231 
C30SrSOSICRWEDsRWED,RWEDsRI 14-AUG-81 10351(10.) 


Totel of 2.72. blocks in 1. file 


DIR €305%304] 


> 
>DIR/FULL EX2D4T.LST 


Directory DROSC305,303) 
15-OCT-81 16309 


2) EX2D4T.LST#4 (37342150) 8./8,. 15-OCT-81 16:08 
C7305] CRWED*sRWED*RWED? RI 


Total of &8./8. blocks in 1. file 


Example 4-9 File Ownership 
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>COPY A.TSK [305,306] A.TSK 


FROM 


A.TSK A.TSK (OWNER 
OWNER: OWNER: STAYS SAME) 
[305,303] [305,303] 


1) USER [305,303] COPIES FILE TO [305,306] 


>COPY [305,306]B.MAC * * 


B.MAC B.MAC 
OWNER: OWNER: 
[305,303] [305,306] 


USER [305,303] COPIES B.MAC FROM [305,306] 
TO HIS OWN UFD. 


>COPY/OWN A.TSK [305,306] A.TSK 


FROM 


A.TSK A.TSK 
OWNER: OWNER: 
[305,303] [305,306] 


USER [305,303] COPIES A.TSK TO [305,306] 
MAKING THE OWNER [305,306] 


TK-7676 


Figure 4-4 Transferring File Ownership 
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When a user copies a file from his UFD tto another UFD, he 
maintains ownership of the file and his UIC will be stored with 
the file. In Figure 4-4, at item 1, user [395,383] copies the 
file A.TSK to UFD [305,386] and remains the owner of file. The 
owner of UFD [305,306] may or may not have access to that file, 
depending upon what protection rights the owner of the file has 
given to members of the same group. When a user copies ae file 
from another UFD, the user becomes the owner of the file as shown 
in item 2 of the figure. If the user wishes to transfer file 
ownership to the UFD to which it is being copied, the /OWN 
qualifier should be used, as shown in item 3. 


= COPY VIF.TSK C305°304]VIP. TSK 
PDIR/FULL C305*/3041VIF. TSK 


Directory 0DK23030523047 
-15-0EC-81 12:22 


VIF.TSKS4 (1495) 7/7, c 


15-DEC-81 12%21 
C305 303] CRWEDSRWED»RWEDSRI 


Total of 7./7. blocks in i. file 


PCOPY C305*304I]PRIMES.TSK [3057303] 
“DIR/FULL FRIMES.TSK 


Directory DK2:0305%303] 
15-DEC-81 12322 


FRIMES.TSK$2 (1695) 46./46, 


C 15-DEC-81 12:22 
C305 3031 CRWED,RWEDPRWEDS RI 


Total of 46./46. blocks in 1. file 


>COPY/OWN VIF.TSK C305» 304]VIF. TSK 
sDIR/FULL C30Sr304I VIF. TSK 


Nirectory DK230305»3043 
1S5-DEC-81 12323 


VIF .TSKS1 (1496) Fel? C 15-DEC-81 12323 
C305 S304 CRWED*SRWEDeSRWED RI 


Total of 7./7. blocks in 1. file 


Example 4-18 Transferring File Ownership Samples 
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File Access Rights 


There are four groups of users, aS Shown in Table 4-4. The 
owner is the user whose UIC is saved with the file. Each one of 
these groups can be awarded up to four different types of access, 
as listed in Table 4-5. If the user has not’ specified a 
protection, the system will assign the default file protection 
shown in Table 4-6. 


Table 4-5 Access Rights 


rr . ee " “ sous cssceaenr snes 
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Default File Protection 


Table 4-6 Default File Protection 
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Setting and Changing File Protection 


The user may change the protection on any file that he owns, 
no matter where it resides, by using the SET PROTECTION command. 
However, another user who is a member of the user's group or world 
may not change the protection on the user's file even if he has 
read, write, extend and delete privileges. A privileged user may 
change the protection on any file. The format of the command is 


shown below. An example of issuing the command is’ shown in 
Example 4-ll. 


Command Format 


>SET PROTECTION 
File? INFO.TXT 


Code? (SY:RWED,OW:RWED,GR:RWED,WO:R 


*sDLIR/FULL INFO. TXT 


Directory [IK2:0305%3033 
IS-DEC-81 12323 


INFO.TXT#1 (2092) 60./60- 


O7-JUL-80 12347 
C305*303I1CRr Ryo] 14-AUG-81 10:54(11.) 


Total of 60.760. blocks in 1. file 


os 


SET FROTECTION 

File? INFQ.TXT 

Code? (SYtR,OWfRWEDsGRiR» WO?) 
SOIR/FULL INFO. TXT 


Directory [K2:030523033 
1S-DEC-81 12324 


INFO. TXT#1 (2092) 60+/60+ 


O7-JUL-80 12347 
C305 303 ICR RWED? Re] 14-AUG-81 10354(11.) 


Total of 60.760. blocks in 1. file 


Example 4-11 Setting File Protection 
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Figure 4-5 shows the accessibility of each group of users’ to 
the files located in the UFD [305,303]. It is understood that 
[385,303] is the owner of all the files located there. A member 
of the group [3@5,xxx] would not be able to type the file 
[385,303] VIP.MAC, because the owner of the file has not given 
members of his group read privileges, which you must have to type 
a file. The owner is the only one who can access this file, as no 
privileges have been given to any other group. Do not be misled 
into thinking that a privileged user is not able to access’ this 
file. A privileged user may change the protection on any file. 
This is important to remember: if you should issue the _ SET 
PROTECTION command, you can take away all rights to every group, 
including yourself. 


Equivalent MCR Commands 


Table 4-7 gives the equivalent MCR commands for the _ file 
maintenance operations discussed in this module. The utility 
task, PIP, performs the file maintenance tasks. Documentation for 
PIP is found in the RSX-11M/M-PLUS Utilities Manual. 
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[305,303] 


PROT = SY:,OW: RWE,GR:,WO: 


— > 
eas 
Lvip.tsK__ 


PROT = SY: RWE,OW: RWED,GR:R,WO: 
PROT = SY:RWED,OW: RWED,GR: RWED,WO: 


PAYROLL.TSK 


SYSTEM OWNER GROUP WORLD 


ACCESS = YES ACCESS = YES ACCESS = YES ACCESS = NO 


Pome fm 
pm | we 


COMMANDS 


COPY PAYROLL.TSK 
[UIC] NEW.TSK 


DEL [305,303] 
PAYROLL.TSK 


RUN [305,303] 
PAY ROLL.TSK 


TYPE [305,303] 
VIP.MAC 


EDIT/EDT [305,303] 
LOGIN.CMD 


a 
ce a 


TK-7682 


Figure 4-5 Accessing a File 


LEARNING ACTIVITIES 


1. READ the Section on File Protection and 
Volume Protection, in Chapter 4 of the 


RSX-11M/M-PLUS Command Language Manual. 


2. DO the Written Exercises for this module. 


3. DO the Lab Exercises for this module. 
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